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1. Introduction 

Overview 



This document describes the 2.2 Release of the ESV Workstation software. 

• Chapter 1, "Introduction," (this chapter) describes the functionality 
added in the 2.2 Release. 

• Chapter 2, "Known Bugs in the System," describes the system, ES/os, 
ES/PSX, ES/PEX, X Window System, and OSF/Motif bugs that are 
known to be in the 2.2 Release. 

• Chapter 3, "Bugs Fixed in the Release," describes bugs that have been 
fixed in the 2.2 Release. 

• Chapter 4, "Installation Instructions," describes the installation proce- 
dure for the tapes included in the 2.2 Release. 

• Appendix A, "1.3 Xdefaults File," contains a listing of the 1.3 Release 
/usr/src/samples/.Xdefaults file. 

• Appendix B, "Documentation Corrections," describes additions and 
corrections to the ESV documentation and contains change pages for 
the ESV documentation. 

Additional information will be found in the following document which is 
distributed with the 2.2 Release: 

MIPS Software Binary Release Notes, RISCIos 4.52 Release 

On-line release notes for the operating system, compilers, and OSF/Motif 
are found in the /usr/pkg/rn directory. 
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Added Functionality in the 2.2 Release ^ 

xdm V. 

With the 2.2 Release, the X display manager xdm no longer starts automati- 
cally at system boot. To start xdm, log in at the console login prompt as xdm. 
If the system manager has followed the installation instructions, there will be 
no password required, and xdm will start running. 

Application Defaults Files 

The files in /usr/lib/X1 1/app-defaults define default resource settings for 
various X clients. In previous releases, the files in this directory were defaults 
which included color and other features that were supported on the ESV 
Workstation. Beginning with the 2.2 Release, the X client application de- 
faults files have been restored to the original files which were released by 
MIT's X Consortium. This was done so the clients would be usable on a 
monochrome display attached to an ESV Workstation. 

However, since these application defaults were designed for a mono- 
chrome display, you may want to modify the resource definitions to add color 
and other features in your Xdefaults file, if you have not done so already. 

The MIT defaults for the xterm client, for example, are geared for 
monochrome and also do not include the scroll capability. Resource settings 
not defined in the your Xdefaults file are obtained from the file in the ^ 

app-defaults directory, if present there. A sample Xdefaults file has been | 

provided in /usr/src/samples which sets the X client resources to provide ^- 

colors and other features on the ESV. You can use this file as a basis for your 
own Xdefaults file if you wish. 

For reference purposes, a copy of the 1.3 version of the file 
/usr/src/samples/.Xdefaults is included in Appendix A. Note that comment 
lines in the 1.3 file began with "#" instead of the currently used "!". 



Linking Libraries 



In the 2.2 Release, the X, ES/PEX, and Motif libraries are compiled in both 
BSD4.3 and System V versions. If your application uses BSD4.3 functionality, 
use the -systype bsd43 option when compiling and linking. If your applica- 
tion uses System V functionality, use the -systype sysv option when com- 
piling and linking. The System V version of the libraries are located in 
/usr/lib. The BSD4.3 version of the libraries are located in /bsd43/usr/lib. 
The correct libraries are found when the -systype option described above is 
used. 
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Stereo X Fonts 

Three X fonts have been created to use on stereo screens. They are designed 
to be used where you would like the fonts to be as small as possible to con- 
serve screen space. The new fonts can be accessed through a short alias name 
or a long ISO format name. 

Alias ISO Format 

es5x8 -eands-fixed-medium-r-normal-8-80-75-75-c-50-iso8859-1 

es6x9 -eands-fixed-medium-r-normal-9-90-75-75-c-60-iso8859-1 

es6x9B -eands-flxed-boId-r-normal-9-90-75-75-c-60-Iso8859-1 

Circle and Arc GDPs 

Circle and arc GDPs have been added in the 2.2 Release. They are document- 
ed in the revised chapter "1. ES/PEX" which is found in the changepages at 
the end of this document. 

Name Set Sizes 

The name set size is configurable in the 2.2 Release. This feature is docu- 
mented in the revised chapter "4. Customizing the System" which is found at 
the end of this document. 

Maximum Number of View Tables 

The maximum number of view tables has been increased in the 2.2 Release. 
This feature is documented in the revised chapter "4. Customizing the Sys- 
tem" which is found at the end of this document. 

Cross Hair Cursor 

The cross hair functionality has been added to the E&S Extension. This fea- 
ture is documented in the change pages to chapter 2, "X Extensions" which is 
found at the end of this document. 

Underlay Planes 

Underlay planes have been added to the overlay/underlay functionality in the 
E&S Extension. This feature is documented in the change pages to chapter 2, 
"X Extensions" which is found at the end of this document. 



AVS Dials 



Release 3.0 of AVS incorporates new functionality when using the control di- 
als peripheral device with AVS. For the most part, the dials are treated as de- 
scribed in the AVS User's Guide in the "Network Editor" section. However, 
AVS communicates with the dials peripheral through the X server to provide 
additional flexibility. 



2.2 Release Notes 1 - 3 



Introduction 



The functions performed by the control dials are dependent upon the cur- 
rent location of the X pointer (also called the mouse cursor).When the pointer 
is located within the visible boundaries of a geometry viewer window, the 
functions performed by the control dials are to modify the current object, 
light, or camera for that geometry viewer window. This applies even if the ge- 
ometry viewer window is created by a user network using the "render geom- 
etry" module with the "display pixmap" module. 

When the control dials are performing geometry viewing functions, the 
LED labels on the control dials cabinet display the function performed by the 
dials. Seven of the eight dials have specific purposes; the eighth dial is un- 
used. The functions performed by each dial are listed below: 

X ROT : rotate the object, light, or camera about the x axis. 

Y ROT : rotate the object, light, or camera about the y axis. 
Z ROT : rotate the object, light, or camera about the z axis. 
SCALE : scale the object, light, or camera. 

X TRAN : translate the object, light, or camera in the x direction. 

Y TRAN : translate the object, light, or camera in the y direction. 

Z TRAN : translate the object, light, or camera in the z direction. 

When the X pointer is located within the visible boundaries of the Net- 
work Editor window (the window in which the modules and the connected 
network are displayed), the functions performed by the dials reflect the cur- 
rent state of the Dialsbox Manager or Dials Matrix Manager. Only one of 
these managers can be active at any time. 

When the control dials are performing Dialsbox Manager functions, the 
first eight characters of the module parameter associated with each dial is dis- 
played in the control dials labels. For example, the "clamp" module has two 
parameters which can be associated with the dials: "clamp_min" and 
"clamp_max." If these module parameters are associated with the dials, the 
corresponding dial labels display "CLAMP_MI" and "CLAMPJVIA" when the 
X pointer is in the Network Window. 

When the control dials are performing Dials Matrix Manager functions, 
the dial labels display the same mnemonics as when they are performing ge- 
ometry viewing functions. 

When the X pointer is in other windows, the control dials have no effect 
on the AVS application. If the X pointer is in a window for some other appli- 
cation that responds to the control dials, it works as always with no interfer- 
ence from AVS. 
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Kernel Support for Modem Control 

Kernel support for modem control and CTS/RTS has been added in the 2.2 
Release. This feature now works as documented. 

xtitle Supported 

The client xtitle is now supported. This client changes the title of an xterm 
window, its icon, or both. 



Keyclick 



Keyclick is available with the 2.2 Release. Use the following command to en- 
able/disable keyclick: 

xset c on/off 
If you are starting your server under xdm, you also must increase the key- 
click volume by the following command: 

xset c 100 
Servers starting under xdm have keyclick turned off by default. Servers 
starting under startesv have keyclick turned on by default. 
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2. Known Bugs in the 2.2 Release 



This chapter describes bugs known to be in the 2.2 Release in addition to 
those documented in the 2.0 Release Notes. 

Note: For additional information about operating 
system and compiler bugs, refer to the 
MIPS Release Notes, which are found on-line 
in the /usr/pkg/rn directory. 
Please note the following bug that was reported in the 2.0 Release: 



2.15 dump/restore for multiple tapes 

1) If you use the file system dump command to copy your disk files to mul- 
tiple tapes, and then use the restore command to restore them to disk, all 
of the files may not have been restored properly. In particular, the last file 
of the first tape and/or the first file of the second and subsequent tapes 
may be damaged. The following message will be produced when the sec- 
ond or subsequent tape is read: 

resyncing restore, skipping x records 

The workaround is to use a block size of 1 when doing the restore as 
shown below: 

restore -vrb 1 ly our Jilesy tern jiame 

2) If you use the /bsd43/usr/bin/dd command to copy files, and use a block 
size larger than 1024, it causes incorrect data to be copied. The default 
block size for this command is 512. 



System Bugs 

1.8 pty feature 

The 2.2 Release contains a fix that makes ptys understand the 
ISTRIP flag. If you used 8-bit text in xterms or for rlogins, you may suddenly 
not see the 8-bit text unless you disable ISTRIP using stty. You can disable 
the stripping by using /bin/stty -istrip or /bsd43/bln/stty pass8. 

1.9 bsd43 ctlme manual page error 

The BSD manual page for bsd43 ctime should show that 
#lnclude <sys/type.h> is needed. 

1.10 Xterm doesn't recognize the META key 

When you try to do xmodmap to change the ALT key to be a META key, the 
xterm that you type this into doesn't get the change. In fact, any xterm that 
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has been typed on before the xmodmap has been done, will not see the 
change. Do the xmodmap in your .xinitrc or .xsession file, and you won't 
have a problem. 

1.11 Mapping ALT key to META key 

When using xmodmap to change the ALT key to be a META key you must 
do /bin/stty -istrip in the xterm that is going to want META key presses. This 
is to ensure that all 8 bits of the keycode get to the xterm. 

1.12 ES/Dnet can't handle dots (.) in pathnames 

When trying to copy a file from the ES V to the VAX using the copy command, 
if the ESV pathname includes a dot (example: /tmp/junk.dir/foofile), 
ES/Dnet cannot find the file. The dot is treated as if it were a step down in the 
directory structure (example: /tmp/junk/dir/foofile). 

1.13 libcurses.a is incorrect for bsd43 

There is a problem with libcurses.a and bsd43. The cursor position is incor- 
rectly reported when using a tab character. 

1.14 F77 2.20 internal file READs error 

In F77 2.20 (and prior releases) when using an internal file for READing there 
are values which cause the I/O routines to include the newline character into 
the string. This causes an error. The workaround is to use an EQUIVALENCE 
statement with the variables, or to use an I/O format which matches the 
variable in the READ statement. 

1.15 F77 2.20 doesn't compile with -extend _source 

This bug manifests itself whenever you try to declare an array variable, and 
initialize it in the same statement, and use the -extend_source option of the 
compiler. 

1.16 C 2.20 misrepresents conversion of double to unsigned int 

When converting a double to an unsigned int, the leftover bits are assigned 
Is instead of 0s. 

1.17 F77 2.20 fails to compile a parameter statement 

F77 fails to compile a parameter statement which uses a function like char(). 
The compiler issues an error statement which indicates that an illegal initial- 
ization has been attempted. The workaround is to not use a parameter state- 
ment for this purpose. 
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1.18 F77 2.20 cannot use integer parameter as length spec for CHARACTER 

statement 

This bug appears whenever a structure is declared in FORTRAN which has a 
char variable whose length specifier is declared in a parameter statement. We 
have a patch available for customers who have this problem. Call the hotline 
if you need the patch. 

1.19 Compiling with relative paths 

A problem occurs when a user is compiling FORTRAN or C code and using 
more than one include file, where both Include files are defined using rela- 
tive paths. The problem exists when the first header file is relative to the 
source code, and the second header is relative to the first include file, not the 
source. The workaround is to have the second relative path be relative to the 
source code even if the second include file is included in the first include file. 

1.20 2D array reference C 2.20 compiler bug 

A 2D array is passed into a C-language subroutine. The parameter declaration 
is consistent with the definition of the array (e.g., float a[4][4];). The compil- 
er generates wrong code for references to the array elements in the subroutine. 
Synopsis: 

float arr[4][4]; /* array definition */ 



void subr(a) 

float a [4] [4]; 
{ 

a[0][0] = 0.0; /* destroys stack */ 

} 

If the parameter to the subroutine is declared as 

float (*a) [4]; 

the program will run as intended. 

As a second workaround, which does not require the source code to be 
modified, use the -oldc switch on the compile command line. We have a 
patch available. Call the hotline if you need the patch. 

1.21 Timing problem with ES/Dnet and NIS 

When ES/Dnet starts up, it modifies the effective Ethernet address for the 
ESV. This modification can cause a failure of the NIS binding on some net- 
works. If your network is unable to resolve the changed address successfully 
on its own (within a few minutes), you will need to issue the following com- 
mand on each of the NIS server machines (root permission required), 
arp -d esvname 
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1.22 Error in csh manual page 

There is an error in the csh manual page under the "Files" section. It currently 
reads: 

~/. cshrc Read at beginning of execution by each shell, 
/etc/cshrc Read by login shell, after /cshrc at login. 
e&~/. login Read by login shell, after .cshrc at login. 



It should read: 

~/. cshrc Read at beginning of execution by each shell. 

/etc/cshrc Read by login shell, before ~/. cshrc at login 
-/.login Read by login shell, after -/.cshrc at login. 

1.23 Garbled manual page headers 

For manual pages that are not pre-formatted, the /usr/lib/tmacan.new macro 
package generates a header line that many appear garbled if the command 
name is long. The macro file can be edited to produce a header with only the 
command name centered on the page. In the head of page macro change the 
following line from 

.tl @\\*(]H@\\*(]D@\\*(]H@ 

to 

.tl @@\\*<]H@@ 

1.24 Blank manual pages when using xman 

The following is a list of ES/os manual pages that have a blank first page. To 
view these manual pages you must scroll down a page. 

lastcomm (BSD) 

cfe 

vi 

view 

vedit 

dup2 (c) 

len (f) 

Irand (f) 

rand (f) 

srand (f) 

Idfcn 

swap (m) 

battlestar (BSD) 
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1.25 xman scrolling problem 

When looking at a manual page that is larger than the xman window, if you 
scroll down the page and stop when the bottom line of the window has text in 
it, and then scroll back up, the last line keeps the previous text in it. 

1.26 stty command does not work on redirect 

In the 2.0 release this bug was reported as fixed. It has been fixed for the BSD 
version but the System V version still does not work. 

The Stty command should be able to redirect requested tty settings to a 
line other than the currently logged in tty when used as follows: 

- /bin/stty [setting] < /dev/tty3 
-/bsd43/bin/stty [setting] > /dev/tty3 
The above commands should set the requested default(s) for tty3. This is im- 
portant if the tty line goes to a "dumb" device that requires certain defaults, 
like -ixany, but is not able to set them interactively. 

The stty commands do modify the defaults for the specified tty, but the 
original defaults are restored as soon as the stty command exits. 

1.27 sendmail doesn't handle both NIS and named services 

If you use sendmail and NIS, either domain name services start to work and 
NIS quits, or vice versa. 

1.28 Memory leak 

Under some conditions the 2.2 Xserver may exhibit a memory leak. This is 
most noticeable with certain non-default fonts. The workaround is to stop and 
restart your Xserver. If your machine has this problem, contact customer sup- 
port on the hotline. 

ES/os Bugs 

2.16 Unnecessary file checking during bootup 

When re-entering multi-user mode after having shut the machine down to sin- 
gle-user, all file systems will be checked whether they are dirty or not. Since 
shutting down the single user doesn't automatically unmount the file systems, 
they can't be marked as clean and will be checked when you come back up. 
To avoid this, either unmount by hand, or shut the machine down to the boot 
prompt using the SHUTDOWN command. 

2.17 X server process can monopolize resident memory set 

It is possible for the X server to grow in size and monopolize most of the res- 
ident set pages in memory. This most often occurs when multiple sets of large 
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pixmaps are displayed. The system may begin to thrash and processing be- 
comes very slow. Workaround by stopping and restarting the server. 

A second workaround is to run a program which allocates and references 
memory to the extent that enough system memory is freed to avoid thrashing. 
The program would simply exit when it has claimed most of physical memory 
for itself. The X server needs to run while the memory reclaiming program 
runs. This is required so the X server can push its physically resident pages to 
backing store. The following is an example of such a routine: 

main (argc f argv) 
int argc; 
char *argv[] ; 
{ 

int i, repeat; 

volatile char *a,*reset,b; 
printf P%d\n", strtol (*++argv, 0,0) ) ; 

if((reset=a= (char *)malloc (strtol (*argv, 0, 0) ) ) == (char*)0){ 
perror ("") ; 
exit ( ) ; 
} 
for ( repeat=0 ; repeat<5 ; repeat++) { 

printf ("repeat - %d\n", repeat); 
a = reset; 

for(i=0;i<strtol(*argv,0,0) ;i+=4096) { 
b = *a; 
a+=4096; 
} 
} 
} 

ES/PEX Bugs 

4.38 Bundle tables have only one predefined entry 

ESV documentation for PHIGS and PHIGS PLUS description tables states that 
the different PHIGS bundle tables have 5 or 6 predefined entries as required 
for minimum support. There is only one predefined bundle entry for each type 
of table. 

4.39 Can't get DeviceMotion events when PHIGS monitor is running 

If you change the parameters to popenxphigs so that it uses the PHIGS 
monitor and forces client-side CSS, the client may no longer get Device Mo- 
tion events from the dial box. If the client doesn't use the PHIGS monitor or 
client-side CSS, it gets Device Motion events with no problems. (Under both 
cases, the client receives all vanilla X events.) 
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4.40 Fill Area Set primitives containing zero fill areas hang server 

If you send a Fill Area Set primitive which has zero fill areas in the set to the 
server, the server hangs. It has to be restarted when this happens. 

4.41 Errors 205 and 206 not generated 

Error 205 on SET ELEMENT POINTER AT LABEL and Error 206 on 
DELETE ELEMENT BETWEEN LABELS are not generated. The PEX error 
131 (PEXLabelError) is generated instead and the application is aborted. 

4.42 HLHSR mode with circle and arc GDPs 

Setting the HLHSR mode for multi-pass traversal while using circle or arc 
GDPs causes visual problems in edges and line colors. 

4.43 pcomposematrix may cause segmentation fault with System V 

The following call causes a segmentation fault: 

pcomposematrix3 (concat2, currmatrix, &error, currmatrix); 

If the line is replaced as follows, it works. The problem has to do with 
currmatrix being used twice. 

pcomposematrix3 (concat2, currmatrix, &error, temp); 
copymatrix(temp, currmatrix) ; 

4.44 TRANSFORM POINT 3 breaks under certain conditions 

In the PHIGS function ptran_point3 (TRANSFORM POINT), the address of 
the input point to be transformed should not be the same as the address of the 
output transformed point. If it is, erroneous data is returned. 

4.45 Picking on a stereo image returns the wrong structure ID 

Picking on a stereo image returns the wrong structure ID. The structure id re- 
turned is a 0. 

4.46 PHIGS valuator with dialjbox and PET -1 segmentation faults 

When using the valuator device and Prompt/EchoType -1, you must set each 
of the fields in the data record. The label, format, lowjabel, and highjabel 
should be set to NULL. 

X Window System Bugs 

5.39 xmag corrupts global screen variable 

The xmag client corrupts the global screen variable when the environment 
variable DISPLAY is set to a different display other than the default screen 0. 
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5.40 xclock leaves trails from hand outline 

xclock leaves trails of pixels behind the hands as they move around. 

5.41 Small dashed zero width arcs can crash the server 

If an arc drawn through XDrawArc(s) is so small that no points are to be 
drawn, and the line style is dashed, the X server causes a segmentation fault. 

OSF/Motif Bugs 

6.33 Setting background pixmaps of scale widgets 

When setting the XmNbackgroundPixmap resource of a scale widget, the 
border of the widget gets set with the specified pixmap, but the background 
(the trough of the scale widget) is not set. 

6.34 ESCAPE and RETURN button presses lost 

XmNinputCallback for a drawing area does not get called when the ESCAPE 
key or the RETURN key is pressed. 

6.35 XtSetKeyboardFocus and the text widget don't work together 

When a text widget and a drawing area are displayed simultaneously, the text 
widget does not receive keyboard events. 
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3. Bugs Fixed in the 2.2 Release 

This chapter lists bugs reported in previous releases that have been fixed in 
the 2.2 Release, as well as bugs not previously reported but fixed for this 
release. If it is a previously reported bug, the original bug number is placed in 
parentheses next to the title. 

System Bugs Fixed 

emacs -nw didn't work with xterm, esconsole terminal types 

Trying to run emacs -nw, the ESV complained that TERM type xterm or 
esconsole was not powerful enough to run emacs. 

man didn't work correctly 

sysv man no longer cycles through a manual page more than once. 

size_t declared incorrectly 

size_t was not declared correctly in bsd43 include files. 

Security hole 

The streams ioctl routine allowed a non-privileged user to write from one 
window into another window's input stream. 

vgrlnd needs to reference troff not Itroff 

The utility vgrind did not run because it references Itroff. A symbolic link 
from /bsd43/bin/troff to /bsd43/bin/ltroff has been put in. 

The command to execute is vgrind -t <fname> | Ipr -t 
Manual page for generalized_structure_element had errors 

The manual page for generalized_structure_element had a blank first page. 
More importantly, the reference to 

Fillarea Front/Back Face Distinguish 
typedef struct { 

Pint value; 
} Pgse_f ront_back_distinguish; 

was changed to: 

/* Fillarea front/back z-buffer distinguish GSE structure */ 
typedef struct { 

Pint distinguish; 
} Pgse_f ront_back_distinguish; 
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xdm implementation 

The xdm account did not run the xdm-restart command to restart xdm after 
an ALT-F4 at the xdm login screen. 

xdm log file (2.14) 

The X display manager xdm created a log file /usr/tmp/xdm-errors.This file 
grew each time you logged in and out of the system via xdm.The only way to 
safely remove this file was to reboot the system. At this time, the old file 
would be removed and a new one opened. It was recommended that you re- 
boot the system periodically so as to not allow the file to grow too large. 

FORTRAN parameter declaration (2.13) 

The FORTRAN PARAMETER (epsilon = 4 3cbOOOOOOOOOOOOO'x) failed. De- 
claring an epsilon variable using a literal hex value such as 
PARAMETER (epsilon = '3cb0000000000000'x) failed to produce valid re- 
sults when multiplied by a floating point number. This problem did not occur 
if the variable assignment was not made as PARAMETER. 

Pascal compiler initialization crash (2.11) 

A Pascal compiler bug caused a crash during initialization due to incorrectly 
generated code attempting to clear a local variable. 

If a local variable was defined which was a record consisting of a 255- 
byte array and a two-byte integer, the compiler generated incorrect code to 
clear the array and a bus error occurred. 



passwd 



When trying to execute the passwd command on the gcpu side of a Local 
Server machine, it hung indefinitely if the /etc directory was on an imported 
nfs. 

/etc/exports file 

The /etc/exports file contained an incorrect example of how to limit access 
to file systems by other machines, as follows: 

# /usr2 mips sprint quacky # export to only these machines 

You had to edit this file so that it showed a correct example for limiting 
access to certain machines. The exports command with the -access= and 
-roots options showed the correct procedure. The exports manual page gave 
correct examples. 

Illegal numerics halt 33 MHz CPU 

If a program divided by zero or performed any other illegal numeric opera- 
tion, and was compiled and run on a 33MHz ESV stopped the CPU. 



3 - 2 2.2 Release Notes 



c 



( 



( 



Bugs Fixed in the 2.2 Release 



X server (1.3) 

If you typed xinlt on a machine where an X server was already running, the 
initial X server hung. The CTRL- ALT-BREAK key sequence would not kill it. 

ES/PEX Bugs Fixed 

Multiple DirectColor windows didn't work together 

When you had a DirectColor X window, then started another application 
which created a second DirectColor colormap and window, the hardware 
didn't install the colormap properly. When the pointer went back to the first 
X window, one or more of the colors in the hardware copy of the colormap 
were corrupted (black turns to red). 

XlnstallColormap (called by the window manager) didn't seem to work 
when there was more than one virtual DirectColor colormap. 

XQueryColor did not return correct color 

When you loaded a set of 256 colors with XStorecolors, then queried a color 
value with XQueryColor, you got incorrect values for red and green. If you 
stored a single color using XStoreColor, then read with XQuerycolor, you 
got correct values. 

Missing some supported characters on dial labels 

The PHIGS dial labels only supported characters a-z, 0-9, space, comma, mi- 
nus, and period. The X input extension version supports many more. 

Error reporting degenerate structure paths 

The inquire ancestors and descendants routines no longer report paths where 
the starting structure is the only member of the maximal path. 

psisi set incorrect index 

The routine psisi didn't set the correct index. In the previous release, the 
incorrect value was set for interior style index when using the FORTRAN 
binding. 

pcompose_tran_matrix(3) functions broken 

pcompose_tran_matrix and pcompose_tran_matrix3 generated an incor- 
rect matrix result. These functions pre-multiplied the calculated compound 
matrix with the provided matrix to produce the resulting matrix. 

pinq_elem_type_size/pinq_elem__content crash 

If the functions pincL_elem__type_size or pinq_elem_content were called 
with a element number, the program crashed. 
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FORTRAN - pgdp(3) crashed on an unsupported id 

If either pgdp or pgdp3 was called with an unsupported id and a non-packed 
data record, the function core dumped trying to unpack the data record. 

copy all elements from structure killed X server 

The command copy all elements from structure caused the server to die. 

Picking with no structures posted hung server 

If you used XPick for picking when no structures were posted, the server 
would hang. 

Incorrect pick results 

Occasionally a pick report incorrectly gave a pick path length of 0. When an 
event was processed for either XPickEventOffset or 
XPickPathEventOffset, a check was not done to see if a pick actually 
occurred. The information printed out may not be valid if a pick did not occur. 

When pick highlighting was off, picked line disappeared 

When XSetPickHighilghtlngMode was set to pick_highlightlng_off, pick- 
ing of a line removed the line until the picture was redrawn. 

HLHSR modes did not work properly for lines 

There was bad end point match on polylines. 
Using direct color visuals popen_ws 

If a window created on a direct color visual was used in the call to 
popen_ws, the window was changed to use the true color colormap. 

Edge pattern affected hollow polygons 

There were a number of strange effects related to edge patterns. Edge patterns 
affected hollow polygons-even if the edges weren't drawn. Also the line pat- 
tern affected polygon edges. 

1.3 thin layer generated large executables 

Using the 1.3 thin layer generated executables in the 2-3 Mbyte range even 
for very small programs. 

1.3 thin layer plnqelemcontent (4.32) 

The 1.3 thin layer plnqelemcontent routine did not work. It produced a seg- 
mentation fault. 



( 



( 



( 



3 - 4 2.2 Release Notes 



Bugs Fixed in the 2.2 Release 



INQUIRE HLHSR MODE (4.33) 

This inquiry routine incorrectly returned an error, even when no error oc- 
curred. If the error indicator was 0, the data is correct. Otherwise, the returned 
values may have been incorrect. 

SET EDGETYPE (4.36) 

Setting the edgetype to something other than solid in SET EDGETYPE 
caused unpredictable visual effects. 

RETRIEVE STRUCTURES (4.29) 

The archive retrieval function RETRIEVE STRUCTURES could hang. When 
the routine was called, and the list of structures to retrieve was not in se- 
quence, the routine may not have returned. 

Quad meshes with vertex and facet normals (4.27) 

Certain sizes of quad meshes with vertex and facet normals were not dis- 
played correcdy. The last row was incorrect. If the facet normals were not set 
for the mesh, it was displayed correcdy. 

DeleteStructures failed (4.26) 

Under certain conditions a PEX bug using labels and delete structure caused 
DeleteStructures to fail. 

INQUIRE PICK DEVICE STATE 3 (4.30) 

The value in the lnit_pick.depth field which was returned when 
INQUIRE PICK DEVICE STATE 3 was called was not correct. Also, if you 
were using the 1.3 thin layer, this procedure should not have been used at all, 
because the buffer size which was returned was incorrect and may have 
caused unpredictable behavior. 

INQUIRE DEFAULT LOCATOR DEVICE DATA 3 (4.31) 

INQUIRE DEFAULT LOCATOR DEVICE DATA 3 returned an error. A call to 
this routine may have generated a bad device error (error 250) even though a 
valid locator device was given. 

Improperly oriented polygons handled incorrectly 

Any polygon that is oriented incorrectly in PHIGS (that is, has a clockwise ori- 
entation) is getting an incorrect facet normal. This results in incorrect back- 
face removal and shading. Specifically, the right half of the picture looks fine 
and the left half has problems. 

ddpex (4.10) 

Errors returned from ddpex were not consistent. 
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Invalid color type (4.17) 

Elements with invalid color types produced errors. The system checked all el- 
ements that contained colors for unsupported color types. If an element with 
an unsupported color type was found, the element was rejected and an error 
issued. This was different from the proposed PHIGS PLUS standard, which 
states that the correct action is to build the element, detect the bad color type 
during traversal, then use the default color. 

RGB values (4.18) 

RGB values needed to be clamped to reasonable ranges (0.0 to 1.0) when the 
client program supplied out-of-range data. This was not done, and RGB val- 
ues outside the range 0.0 to 1.0 had unpredictable results. 

Cylinder GDP (4.34) 

If a Cylinder GDP with indexed colors contained a cylinder list that was too 
large, the server hung. No cylinder list which used indexed colors could con- 
tain more than 33 endpoints. 

SET FACE DISTINGUISHING MODE (4.37) 

If you set the back face distinguishing mode to yes in 
SET FACE DISTINGUISHING MODE, and you shaded a back facing poly- 
gon, the polygon appeared black. 

X Window System Bugs Fixed 

Unable to use System V termlnfo and curses with X libraries 

You were unable to use System V terminfo and curses with X libraries. 
xwd hung server on a full screen window dump 

If an X window was enlarged to be the full screen and an xwd was run on 
that window, the server hung. 

DeviceMotion extension events (5.8) 

DeviceMotion extension events for dials did not propagate through the win- 
dow hierarchy as documented in the XI 1 Input Extension Library Specifica- 
tion. For a finite number of sub windows, you can request the event for each 
of the windows. 

XSync (5.10) 

When the device focus was set to the tablet, calls to XSync may have caused 
a bus error. When the device focus was set to the dials, calls to XSync may 
have caused the X Server to crash. 
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XQueryDeviceState (5.12) 

XQueryDeviceState killed the server when you asked for information about 
the dials. 

xman crashed in XCreateWindow (5.36) 

xman crashed with the error "cannot do bold and italics" on manual pages 
that attempt to do bold and italics at the same time. One example of this was 
the XCreateWindow manual page. If you scrolled down through it, xman 
would die at the certain point that it tried to do both bold and italics. 

XGrabDeviceButton(5.11) 

XGrabDevlceButton returned a NOMATCH error ("device does not support 
input class BUTTONS") when you tried to grab a tablet button. 

XAIIowEvents (5.16) 

XAIIowEvents did not allow events to be sent to the client that had grabbed 
the keyboard or the mouse. 

Keydick didn't work (5.20) 

Turning keyclick on and off through xset never produced a key click noise, 
even though the keyboard supports it. 

XI_KEYBOARD (5.26) 

XI_KEYBOARD was not declared in Xl.h for XListlnputDevices. Compila- 
tion returned the error XI_KEYBOARD undefined. 

Picking in perspective projection (5.27) 

With the projection specified as perspective, a picking program got zeroes for 
the model coordinates when a primitive was picked. If the projection was 
changed to parallel, the model coordinates were returned correctly. 

This occurred because the perspective matrix was non-invertible, making 
it impossible to compute a 3D pick point. There is a flag for this condition 
which can be checked. The typical cause for the perspective matrix to be non- 
invertible is putting the projection reference point on the front clipping plane. 
This created a matrix with zeroes in the column. That matrix was non- 
invertible making it impossible to return a model space pick point. 

Turning the bell on/off (5.31) 

Using xset to turn on/off the bell (xset b off, xset b on) had no effect; the 
bell always rang. 

Overlay Planes (5.35) 

XGetlmage and XPutlmage did not work with overlay planes under all con- 
ditions. 
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4. Installation Instructions 



This chapter contains information on ESV Workstation tape drives and pro- 
vides installation instructions for release tapes. This chapter is organized as 
follows: 



OS Kernel Information 
Configuration Information 
Tape Drive Data Cartridge Information 
2.2 Release Subpackage Sizes 



Page 

4-1 

4-2 

4-6 

4-7 



make.xman.sections Manual Page Setup Script 4-12 



Remove Package/Subpackage Utility 

ES/os Domestic/Foreign Tape- Update 

ES/os Domestic/Foreign Tape- Scratch 

ES/PEX Server Tape 

ES/PEX Library Tape 

ES/PSX Tape 

MlPS-Pascal RISCompiler Tape 

MIPS-FORTRAN RISCompiler Tape 

ES/Dnet Tape 

AVS Tape 

LAT Host Services Tape 

ES/Diskless Node Tape 

ES/Kodak Printer Tape 

Visix Looking Glass Option 

Caution: You should carefully read the "OS Kernel 
Information" section before you begin the 
software installation. 



4-12 
4-14 
4-27 
4-43 
4-48 
4-52 
4-55 
4-59 
4-63 
4-70 
4-73 
4-77 
4-92 
4-95 



OS Kernel Information 



There are four kernels available on the tape. For the 25 MHz CPU there is the 
"development" and the "non-development" kernels. The same is true for the 
new 33 MHz CPU. The "non-development" kernel provides smaller resource 
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allocations and can be used when systems mainly run existing applications. 
This kernel is installed on the ESV when it is shipped from the factory. For 
systems in which large application compiles and builds are done, the "devel- 
opment" kernel, which provides larger resource allocations, should be used. 

To determine which type of kernel has previously been loaded on the 
system, you can boot the system and type the following command: 

-unazne -A 

This command will print the following system information: 

sysname, nodename, release, version, machine, m_type, and base_rel 
The m_t ype will be one of the following: 

• ml20-l if the non-development kernel was installed (25 MHz CPU) 

• ml20-2 if the development kernel was installed (25 MHz CPU) 

• ml20-3 if the non-development kernel was installed (33 MHz CPU) 

• ml20-4 if the development kernel was installed (33 MHz CPU) 

Note that all releases prior to 2.0 had only the 25 MHz development 
kernel. 

If you need to install a kernel other than the one on the system, you can 
do so by following the Operating System Update Installation Instructions, but 
only installing the root and m-120x subpackages. 

Configuration Information 

The ES/os tape, the ES/PEX Server tape, and the ES/PEX Library tape (Devel- 
oper's kit tape) include various optional subpackages. Since each subpackag- 
es requires space on an ESV disk, only those which will be used should be 
installed. The "2.2 Release Subpackage Sizes" section in this chapter pro- 
vides information about disk space utilization of the various subpackages and 
options. 

There are two basic configurations that are installed at the factory. These 
are the "non-development" configuration and the "development" configura- 
tion. Variations to these configurations are used for the Local Server and the 
CDRS (Conceptual Design and Rendering System). The following contains 
recommendations for which subpackages to install if for some reason, you 
need to reinstall the software at your site: 

Non-Development Systems 

Non-Development systems include those that have the following options: 

• Standard Media Kit (comes on all systems) 

• ES/PSX Option (optional) 
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• ES/Dnet Option (optional) 

• LAT Host Services Option (optional) 

• ES/Kodak Printer Option (optional) 

• Visix Looking Glass Option (optional) 

The following subpackages are installed at the factory for each of these 
tapes: 



ES/os Tape (Domestic or Foreign) 

root - installed automatically on scratch install 

ml20-x - installed automatically on scratch install 

usr - installed automatically on scratch install 

cmplrs - you must type y when prompted 

man - you must type y when prompted 

bsd43 - you must type y when prompted 



ES/PEX Server Tape 

executables_s - 
library_s - 
pexs_man - 
fstest - 



you must type y when prompted 
you must type y when prompted 
you must type y when prompted 
you must type y when prompted 



AH Other Options 

all subpackages 



Development Systems 

Development systems could include a mixture of the following options: 

Standard Media Kit (comes on all systems) 

Development Kit (ES/PEX Library Tape, comes on all development 
systems) 

ES/PSX Option (optional) 

MIPS Pascal RISCompiler Option (optional) 

MIPS FORTRAN RISCompiler Options (optional) 

ES/Dnet Option (optional) 

LAT Host Services Option (optional) 
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• AVS3 Option (optional) g~ 

• ES/Diskless Node Option (Local Server or Diskless Node Systems) V 

• ES/Kodak Printer Option (optional) 

• Visix Looking Glass Option (optional) 

The following subpackages are installed at the factory for each of these 



tapes: 



ES/os (Domestic or Foreign) 

All Subpackages 



ES/PEX Server 

All Subpackages 



ES/PEX Library Tape 

executablesj 
library_l 
pexl-man 
pexl-man-unformat 

= ( 



All other Options 

All Subpackages 



Local Server Systems 

Local Server systems have software installed for each of the CPUs (two avail- 
able). This software is installed in different locations on the disk (see Local 
Server installation instructions). 

The following subpackages are installed at the factory for each of these 
tapes: 



ES/os (Domestic or Foreign) 

You may install either the non-development or development configu- 
rations on both the SCPU (server CPU) or the GCPU (graphics CPU). 



C 
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ES/PEX Server Tape 

The SCPU only needs the following subpackages: 
executables_s 
library_s 
pexs-man 

The GCPU may have either the non-development or the development con- 
figurations installed. 

ES/PEX Library Tape 

Both the SCPU and GCPU should have at least the following installed: 
executables_l 
libraryj 
pexl-man 

AH other Options 

Graphics options (i.e., PSX, AVS, Visix Looking Glass) should be in- 
stalled on the GCPU (graphics CPU). Other options can go on either 
CPU depending on disk space available. 

CDRS Systems 

All CDRS Systems should install the tape subpackages as follows: 

ES/os (Domestic or Foreign) 

all subpackages 

ES/PEX Server Tape 

all subpackages 

ES/PEX Library Tape 

all subpackages 

AH Other Options 

all subpackages 
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Tape Drive Data Cartridge Information 

The Evans & Sutherland ESV Graphics Workstation currently uses the 
TANDBERG DATA (SIEMENS) 3660 Series Tape Drive. Data cartridges that 
have proven to work on this drive include the following: 



C 



Tape 






Mbyte 




Vendor 


Product 


Length 


Capacity 


Notes 


3M 


DC600A 


620 ft 


120 meg 


Used prior to 2.0** 


3M 


DC615A 


150 ft 


30 meg 


Used prior to 2.0** 


BASF 


DC600H 


620 ft 


120 meg 


Used prior to 2.0** 


3M 


DC6037 


150 ft 


37 meg 


Used for Software 
Distribution 


3M 


DC6150 


600 ft 


150 meg 


Used for Software 
Distribution 



** We have found that these tapes cause pre-mature head wear and are not 
recommended on the ESV anymore. They may be used if the new tapes are 
not available. 
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2.2 Release Subpackage Sizes 




Table 4-1. 


ES/os Domestic 2.2 




Subpackage 


Bytes 


Kbytes 


Meg 


root* 


9765528 


9536 


9.31 


ml20-x* 


4598256 


4490 


4.38 


usr* 


31493347 


30755 


30.03 


usrjielp 


640488 


625 


0.61 


usr_dvlp 


9820564 


9590 


9.37 


usr_terms 


1564937 


1528 


1.49 


cmplrs* 


11497115 


11227 


10.96 


cmplrs-bsd43 


1676467 


1637 


1.60 


man* 


3609515 


3524 


3.44 


man_misc 


69600 


67 


0.07 


bsd43* 


10260331 


10019 


9.78 


bsd43_troff 


83235 


81 


0.08 


bsd43_dvlp 


3954837 


3862 


3.77 


reconfig 


10722491 


10471 


10.23 


emacs 


8695717 


8491 


8.29 


posix 


3099224 


3026 


2.96 


uucp 


2280577 


2227 


2.17 


sees 


163425 


159 


0.16 


news_readers 


729737 


712 


0.70 


games 


3301530 


3224 


3.15 


mh 


14699326 


14354 


14.02 


Total 








non-development 


58421248 


57052 


55.71 (actual)** 


Total 








development 


119954400 


117142 


114.40 (actual)** 



* Subpackages installed on a non-development system. 

** Actual installed values will be somewhat smaller than the sum of subpack- 
age values. This is due to space used by pkg to record hard links which don't 
show up after an install. These values come from using the bsd43 version of 
df located in /usr/bsd43/bin. 
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Table 4-2. 


ES/os Foreign 2,2 




Subpackage 


Bytes 


Kbytes 


Meg 


root* 


9765528 


9536 


9.31 


ml20-x* 


4598256 


4490 


4.38 


usr* 


31493347 


30755 


30.03 


usr_help 


640488 


625 


0.61 


usr_dvlp 


9820564 


9590 


9.37 


usr_terms 


1564937 


1528 


1.49 


cmplrs 


11497115 


11227 


10.96 


cmplrs-bsd43 


1676467 


1637 


1.60 


man 


3609515 


3524 


3.44 


man_misc 


69600 


67 


0.07 


bsd43 


10260331 


10019 


9.78 


bsd43_troff 


83235 


81 


0.08 


bsd43_dvlp 


3954837 


3862 


3.77 


reconfig 


10722491 


10471 


10.23 


emacs 


8695717 


8491 


8.29 


posix 


3099224 


3026 


2.96 


uucp 


2280577 


2227 


2.17 


sees 


163425 


159 


0.16 


news_readers 


729737 


712 


0.70 


games 


3301530 


3224 


3.15 


mh 


14699326 


14354 


14.02 


Total 








non-develop 
Total 


58421248 


57052 


55.71 (actual)** 


development 


119954400 


117142 


114.40 (actual)** 



c 
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* Subpackages installed on a non-development system. 

** Actual installed values will be somewhat smaller than the sum of 
subpackage values. This is due to space used by pkg to record hard links 
which don't show up after an install. These values come from using the bsd43 
version of df located in /usr/bsd43/bin. 
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Table 4-3. 


ES/PEX Server 2.2 




Subpackage 


Bytes 




Kbytes 


Meg 


executables_s* 


12632281 




12336 


12.05 


library_s* 


9247032 




9030 


8.82 


pexs-man* 


523478 




511 


0.50 


fstest* 


9998535 




9764 


9.54 


xclients 


13038002 




12732 


12.43 


pexs-man-unformat 


919838 




898 


0.88 


demo_s 


5440251 




5312 


5.19 


contrib_s 


7986358 




7799 


7.62 


Total default 


33463296 




32679 


31.91 (actual)** 


All 


61266944 




59831 


58.43 (actual)** 






Table 4-4. 


ES/PEX Library 2.2 




Subpackage 


Bytes 




Kbytes 


Meg 


executables_l 


82544 




80 


0.08 


library_l 


49788350 




48621 


47.48 


cdrs_library_l 


48073814 




46947 


45.85 


pexl-man 


4961280 




4845 


4.73 


pexl-man-unformat 


6538240 




6385 


6.24 


Total non-CDRS 


63714304 




62221 


60.76 (actual)** 


CDRS 


111788000 




109167 


106.61 (estimated) 






Table 4-5. 


ES/PSX 2.2 




Subpackage 


Bytes 




Kbytes 


Meg 


psx 


6885376 




6724 


6.57 (actual)** 
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Table 4-6. MIPS Pascal 2.20 


Subpackage 


Bytes 




Kbytes 


Meg 


cmplrs 


8586764 




8385 


8.19 


cmplrs-bsd43 


1669480 




1630 


1.59 


cmplrs-man 


531339 




518 


0.51 


pascal 


469945 




458 


0.45 


pascal-bsd43 


129909 




126 


0.12 


pascal-man 


33308 




32 


0.03 


Total w/o C cmplr 


762880 




745 


0.73 (actual)** 


All 


11550463 




11279 


11.01 (estimated) 




Table 4-7. MIPS FORTRAN 2.20 


Subpackage 


Bytes 




Kbytes 


Meg 


cmplrs 


8586764 




8385 


8.19 


cmplrs-bsd43 


1669480 




1630 


1.59 


cmplrs-man 


531339 




518 


0.51 


f77 


3854063 




3763 


3.67 


f77-bsd43 


3377222 




3298 


3.22 


f77-man 


66034 




64 


0.06 


Total w/o C cmplr 


7520256 




7344 


7.17 (actual)** 


All 


18307839 




17878 


17.46 (estimated) 








Table 4-8 


. AVS3 2.2 




Subpackage 


Bytes 




Kbytes 


Meg 


avs 


48453632 




47318 


46.21 (actual)** 








Table 4-9. 


ES/Dnet 2.2 




Subpackage 


Bytes 




Kbytes 


Meg 


esdnet 


9134080 




8920 


8.71 (actual)** 



c 
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Table 4-10. LAT Host Services 2.2 



Subpackage 

eslat 



Bytes 

302080 



Kbytes 

295 



Meg 

0.29 (actual)** 



Table 4-11. ES/Diskless Node 2.2 



Subpackage 


Bytes 


Kbytes 


Meg 


droot 


4927018 


4811 


4.70 


dusr 


37711 


36 


0.04 


dvar 


512 





0.00 


Total 


4970088 


4847 


4.74 





Table 4-12. ES/Kodak Printer 


Subpackage 

kodak 


Bytes Kbytes 

371712 363 


Meg 

0.35 (actual)** 




Table 4-13. Visix Looking Glass 2.0 


Subpackage 

lookglass 


Bytes Kbytes 

4469357 4364 


Meg 

4.26 (estimated) 
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make.xman.sections Manual Page Setup Script 

The following procedure needs to be performed after a scratch or update installation, in order 
for xman to "see" newly installed manual pages. 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

1) Login as root. 

2) Type cd /usr/man 

3) Type su bin 

4) Type ./make.xman.sections 

The following questions will determine if we need to clean up the links and 
mandesc file created by a previous invocation of make.xman.sections. You 
may type q at any prompt to exit . 

Do you just want to clean up the links and mandesc file from a previous 
invocation of make.xman.sections and then exit? 

Answer y, n, q: y (takes about one minute) 

5) Type ./make.xman.sections 

The following questions will determine if we need to clean up the links and 
mandesc file created by a previous invocation of make.xman.sections. You 
may type q at any prompt to exit . 

Do vou just want to clean up the links and mandesc file from a previous 
invocation of make.xman.sections and then exit? 

Answer y, n, q: n 

Are you running this after doing an update install? (y, n, q) : n 

(takes about two minutes) 

6) Type exit (to get out of su). 

7) The xman client will now see all manual page files installed on your system when 
invoked. 

8) You should also update the manwhatis database by typing /usr/lib/manwhatis 

Remove Package/Subpackage Utility 

With Release 2.0, a new feature was provided to remove packages or subpackages to free up 
needed disk space. It is called rmpkg. Instructions follow on how to use this tool. 
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/dev/usr mounted on /mnt/usr 

Partition Megs Mounted File System or Partition Usage 



/dev/dsk/iscOdOsO 23 /dev/root 

1 /dev/dsk/iscOdOsl 33 / 

6 /dev/dsk/isc0d0s6 564 /dev/usr 

7 /dev/dsk/isc0d0s7 14 -**** Available Partition ****- 

Disk Device /dev/dsk/isc0d0s2 632 Megabytes Total Size 

Do you wish to change swap partition configuration (y n) [n] ? <CR> 

========== verifying disk space ========== 



Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 



Note: Takes 030 minutes til next user response 



The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

========== extracting files from subpackage archives ========== 

rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage : root . 
Forward spacing the tape. 
Loading subpackage: ml20-3 
Forward spacing the tape. 
Loading subpackage: usr.. 
Forward spacing the tape. 
Loading subpackage: cmplrs 
Forward spacing the tape. 
Loading subpackage: man.. 
Forward spacing the tape. 
Loading subpackage: bsd43 
Forward spacing the tape. 
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rewinding the tape... 

========== making device special files ========== 

Note: You must obtain the appropriate information 
from your network manager or from your old 
local_hostname file before completing this 
section. 

running MKDEV. . . 
done. 



C 



running comply 



running first comply pass . . . 
running second comply pass... 

Note: Ignore any comply messages... 

========== doing uncompress Thu Aug 30 15:27:31 PDT 1990 ========== 

uncompress usr/bin/admin. Z 
uncompress usr/bin/at.Z 

(Uncompresses Occur Here) 

uncompress usr/bin/chkey . Z 
uncompress usr/new/mh/whatnow.Z 
uncompress usr/new/mh/whom. Z 

Once again, before you can type 'y' to the next questions, your system administrator must 
provide you with the following information: 

1) System hostname. 

2) Netmask. 

3) Broadcast address. 

4) Net address. 

5) Domain name for your site. 

The following entries are given for example ONLY! 

Do you wish to configure the network (y n) [n] ? y 



( 
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unit 

Aug 31 07:19:21 tonto unix: installing VME vector: addr 0x8007FFA4 ipl 2, 

vec OxEO 

unit 

Aug 31 07:19:21 tonto unix: Root fstype ffs 

Aug 31 07:19:21 tonto unix: Available memory = 2 9478912 

checking for system core dump. . . 

Internet daemons: routed snmpd snmptrapd portmap inetd timed(slave) . 

Export file systems 

NFS daemons: nfsd biod lockd statd. 

Aug 31 07:19:32 tonto rpc .statd[139] : enter statd_init 

Aug 31 07:19:32 tonto rpc.statd[139] : 1 

Aug 31 07:19:32 tonto rpc.statd[139] : local state = 1 

Starting lpd 

The system is ready. 

tonto Console login: 

WARNING: The System Manager will want to create 
passwords for the root, fstest, and 
esdemo accounts using the passwd 
command while logged in as each of these. 
These accounts provide a security hole 
until you do so. 

Restoring Saved Files from Second Disk 

1) Login as root. 

2) Type mkdir /<disk2Name> (where disk2Name is the name of your second disk). 

3) Type mount /dev/dsk/isc0dl<sx> /<disk2Name> (where sx is the partition 
number you used to create the filesystem on the second disk). 

4) You should compare the files you saved with the newly installed version (using diff). If 
the system portions of the files have changed, you may need to edit your saved files to 
include the system changes. 

5) Now copy saved files from where you saved them on <d±sk2Name> to their respective 
/etc locations. 

6) Typecd /tmp 

7) Type mount -a to mount any nfs disks specified in /etc/fstab. 
Restoring Saved Files from Tape 

1) Login as root. 

2) Typecd/ 

3) Insert backup tape into tape drive. 
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4) Type /bin/tar -xv 

5) You should compare the files you saved with the newly installed version (using cliff). If 
the system portions of the files have changed, you may need to edit your saved files to 
include the system changes. 

6) Now copy saved files from /tmp/etc to their respective /etc locations. 

Final Important Note 

In order for xman to see all manual pages newly installed on the system, you will need to 
run the make.xman.sections script using the instructions found previously in the 
"make.xman.sections Manual Page Setup Script" section of these notes. Perform these 
instructions after you have installed all software tapes provided. 

End of installation 



c 



( 
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ES/PEX Server Tape 2.2 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Caution: It is recommended that YOU are the only user 
logged onto the machine while loading this 
software. 

Installation Procedure Begins Here 

1) Insert ES/PEX Server 2.2 Tape into the tape drive. 

2) If you are at the xdm login prompt (login box) then enter ALT F4. 

3) Login as root. 

4) Typeps -e 

Look for the line that contains the process name xdm. If the process exists, using the 
process ID number located in the first column, type: 

kill <process Id number> 

5) Typecd / 

6) Type /usr/pkg/bin/inst 

Software Package Installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 

return . . . <CR> 

Rewinding the tape... 
Verifying tape id. . . ok 

Extracting packaging information tree... pexs2.2 

Installation Information: 

Packages will be read in from the local Q2 4 tape drive. 
Machine type: ml20-2 

Is the information above correct? (y n) [y]? y 

========== checking subpackages ========== 

The following subpackages may be installed: 
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executables_s — PEX 2.2 Executable Release 

library_s — PEX 2.2 Library Release 

pexs-man — PEX 2.2 Man Page Release 

fstest — fstest Release 

xclients_s — PEX 2.2 XClients Release 

pexs-man-unformat — Unformatted Man Page Release 

demo_s — Demo_s Release 

contrib s — Contrib s Release 



( 



========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 

The current value of the clock is: Wed Jun 26 14:11:11 PDT 1991 
Is the clock correct (y n) [y] ? y 



verifying single-user mode 



This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n]? y 

========== preserving local files ========== 

Running preserve -s for subpackage executables_s . . . files preserved. 

No preserve list or findmods list for library_s- preserve not executed. 

No preserve list or findmods list for pexs-man- preserve not executed. 

No preserve list or findmods list for fstest- preserve not executed. 

No preserve list or findmods list for xclients_s- preserve not executed. 

No preserve list or findmods list for pexs-man-unformat- preserve not 

executed. 

No preserve list or findmods list for demo_s- preserve not executed. 

No preserve list or findmods list for contrib_s- preserve not executed. 



( 



verifying disk space 
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Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

========== stripping old links ========== 



Stripping links for subpackage executables_s . . . 
Stripping links for subpackage library_s... 
Stripping links for subpackage pexs-man... 
Stripping links for subpackage f stest .. . 
Stripping links for subpackage xclients_s . . . 
Stripping links for subpackage pexs-man-unf ormat_s . 
Stripping links for subpackage demo_s . . . 
Stripping links for subpackage contrib_s... 



extracting files from subpackage archives === 



rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: executables_s . . . 

Forward spacing the tape... 

Loading subpackage: library_s . . . 

Forward spacing the tape... 

Loading subpackage: pexs-man... 

Forward spacing the tape... 

Loading subpackage: f stest .. . 

Forward spacing the tape... 

Loading subpackage: xclients_s . . . 

Forward spacing the tape... 

Loading subpackage: pexs-man-unf ormat_s . , 

Forward spacing the tape... 

Loading subpackage : demo_s . . . 

Forward spacing the tape... 

Loading subpackage: contrib_s... 

Forward spacing the tape... 

rewinding the tape... 
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========== running comply ========== 

running first comply pass... 

running second comply pass . . . 

There were no comply messages from the second pass . 

========== doing uncompress Wed Jun 26 14:28:18 PDT 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

Running preserve -r for subpackage executables_s . . . 

No preserve list or findmods list for library_s- no files restored. 

No preserve list or findmods list for pexs-man- no files restored. 

No preserve list or findmods list for fstest- no files restored. 

No preserve list or findmods list for xclients_s- no files restored. 

No preserve list or findmods list for pexs-man-unf ormat_s- no files 

restored. 

No preserve list or findmods list for demo_s- no files restored. 

No preserve list or findmods list for contrib_s- no files restored. 

========== running conversion scripts ========== 

========== pexs-man. conversion Wed Jun 26 14:28:33 PDT 19 91 ========== 

Manpage Conversion... 

Making x_man -> catman/x_man softlink. . . 
Making P_man -> catman/Pjman softlink. . . 

Done. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

# 
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========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? n - See Configuration Information - page 
4-2 



When asked if you want to install a subpackage, please answer with one of 
the following: 

y - Yes, you want to install the subpackage 

n - No, you do NOT want to install the subpackage 

1 - List the contents of the subpackage and ask me again 

Install subpackage executables_l (1 y n) [n]? y 

Install subpackage library_l (1 y n) [n] ? y 

Install subpackage cdrs_library_l (1 y n) [n] ? n 

Install subpackage pexl-man (1 y n) [n] ? y 

Install subpackage pexl-man-unf ormat (1 y n) [n] ? y 

Selected subpackages : 

executables_l library_l pexl-man pexl-man-unformat 

Is this what you want (y n) [y] ? y 



setting system clock/calendar 



The current value of the clock is: Thu Jun 27 13:27:19 MDT 1991 
Is the clock correct (y n) [y] ? y 



========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 
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No preserve list or findmods list for executables_l- preserve not executed. 
No preserve list or findmods list for library_l- preserve not executed. 
No preserve list or findmods list for pexl-man- preserve not executed. 
No preserve list or findmods list for pexl-man-unf ormat- preserve not 
executed. 



C 



== verifying disk space ========== 



Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage executables_l . . . 
Stripping links for subpackage library_l... 
Stripping links for subpackage pexl-man... 
Stripping links for subpackage pexl-man-unf ormat .. . 



extracting files from subpackage archives 



( 



rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: executables_l . . . 

Forward spacing the tape... 

Loading subpackage: library_l... 

Forward spacing the tape... 

Forward spacing the tape... 

Loading subpackage: pexl-man... 

Forward spacing the tape... 

Loading subpackage : pexl-man-unf ormat . 

Forward spacing the tape... 

rewinding the tape... 



========== running comply === 

running first comply pass . . . 

4-50 
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running second comply pass... 

There were no comply messages from the second pass. 



doing uncompress Thu Jun 27 14:00:32 MDT 1991 
cleaning up old versions ========== 



An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

Clean up pexl . libra ry_l 2.0 (y n) [n] ? y 

Clean up pexl .pexl-man 2.0 (y n) [n] ? y 

Clean up pexl .pexl-man-unformat 2.0 (y n) [n] ? y 



========== restoring preserved user files ========== 

No preserve list or findmods list for executables_l- no files restored. 

No preserve list or findmods list for library_l- no files restored. 

No preserve list or findmods list for pexl-man- no files restored. 

No preserve list or findmods list for pexl-man-unf ormat- no files restored. 

========== running conversion scripts ========== 

========== pexl-man. conversion Thu Jun 27 14:01:42 MDT 1991 ========== 

Manpage Conversion... 

x_man exists 
P_man exists 
C_man exists 
m_man exists 
man3 exists 

Done. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

# 
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ES/PSX Tape 2.2 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 

Installation Procedure Begins Here 

1) Insert ES/PSX Tape into the tape drive. 

2) If you are at the xdm login window box, type ALT-F4. 

3) Login as root. 

4) Typecd / 

5) Type /usr/pkg/bin/inst 
Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 

return. . . <CR> 

Rewinding the tape . . . 

Verifying tape id. . . ok 

Extracting packaging information tree... psx2.2 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20 

Is the information above correct? (y n) [y] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 

psx — PSX 2.2 Release 

========== selecting subpackages ========== 



( 



( 



C 
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You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 

The current value of the clock is: Wed Sep 26 09:58:24 PDT 1990 
Is the clock correct (y n) [y] ? <CR> 



verifying single-user mode 



This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for psx- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? <CR> 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

If you see this type of error message: 

space: error: fstabind(): couldn't find device file for dev=0xl439 

there is a filesystem linked through NFS to another system which must be removed before 
the installation can be performed. 



stripping old links 
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Stripping links for subpackage psx. . . 

========== extracting files from subpackage archives ========== 

rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape. . . 

Loading subpackage: psx... 
Forward spacing the tape... 
rewinding the tape... 

========== running comply ========== 

running first comply pass... 

running second comply pass . . . 

There were no comply messages from the second pass. 

========== doing uncompress Wed Sep 26 10:01:10 PDT 1990 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for psx- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n]? y 

========== installation complete ========== 



( 
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MlPS-Pascal RISCompiler 2.20 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Installation Procedure Begins Here 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 

1) Insert the MlPS-Pascal RISCompiler 2.20 Tape into the tape drive. 

2) If you are at the xdm login window box, type ALT-F4. 

3) Login as root. 

4) Typecd / 

5) Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 
return. . . <CR> 
Rewinding the tape . . . 
Verifying tape id. . . ok 

Extracting packaging information tree... pascal2.20 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20-l 

Is the information above correct? (y n) [y] ? y 

========== checking subpackages ========== 

The following subpackages may be installed: 

cmplrs — MIPS-C 

cmplrs-bsd43 — MIPS-C 4.3 BSD Libraries 

cmplrs-man — MIPS-C Manual Pages 

pascal — MlPS-Pascal 

pascal-bsd43 — MlPS-Pascal 4.3 BSD Libraries 
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pascal-man — MlPS-Pascal Manual Pages 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? n 

When asked if you want to install a subpackage, please answer with one of 
the following: 

y - Yes, you want to install the subpackage 

n - No, you do NOT want to install the subpackage 

1 - List the contents of the subpackage and ask me again 

Install subpackage cmplrs (1 y n) [n] ? n 

Install subpackage cmplrs-bsd43 (1 y n) [n] ? n 

Install subpackage cmplrs-man (1 y n) [n] ? n 

Install subpackage pascal (1 y n) [n] ? y 

Install subpackage pascal-bsd43 (1 y n) [n] ? y 

Install subpackage pascal-man (1 y n) [n] ? y 



( 



Selected subpackages: 

pascal pascal-bsd43 pascal-man 

Is this what you want (y n) [y] ? y 



C 



========== setting system clock/calendar ========== 

The current value of the clock is: Mon Jun 3 14:42:49 MDT 1991 
Is the clock correct (y n) [y] ? y 



========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 
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No preserve list or findmods list for pascal- preserve not executed. 

No preserve list or findmods list for pascal-bsd43- preserve not executed. 

No preserve list or findmods list for pascal-man- preserve not executed. 



verifying disk space 



Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space . 

========== stripping old links ========== 

Stripping links for subpackage pascal... 
Stripping links for subpackage pascal-bsd43 . . . 
Stripping links for subpackage pascal-man... 

========== extracting files from subpackage archives ========== 

rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Forward spacing the tape... 
Loading subpackage: pascal... 
Forward spacing the tape... 
Loading subpackage: pascal-bsd43 . . . 
Forward spacing the tape... 
Loading subpackage: pascal-man... 
Forward spacing the tape... 
rewinding the tape... 

========== running comply ========== 



running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass . 



doing uncompress Mon Jun 3 14:48:30 MDT 19 91 
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========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for pascal- no files restored. 

No preserve list or findmods list for pascal-bsd43- no files restored. 

No preserve list or findmods list for pascal-man- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

# 

Now run the install script to compile a small Pascal test program. 

# /usr/lib/cmplrs/pc2 . 20/checkinstall 

Compiling and linking test program 
Executing test program. . . 

MlPS-Pascal RISCompiler 

The compiler installation completed. 

If the script succeeds the installation has completed successfully, otherwise please call Evans 
& Sutherland for assistance. 



C 



( 
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MIPS-FORTRAN RISCompiler 2.20 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 

1) Insert MIPS-FORTRAN RISCompiler 2.20 Tape into the tape drive. 

2) If you are at the xdm login window box, type ALT-F4. 

3) Login as root. 

4) Typecd / 

5) Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 
return . . . <CR> 
Rewinding the tape... 
Verifying tape id. . . ok 

Extracting packaging information tree... f 772. 20 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20-l 

Is the information above correct? (y n) [y] ? y 

========== checking subpackages ========== 

The following subpackages may be installed: 

cmplrs — MIPS-C 

cmplrs-bsd43 — MIPS-C 4.3 BSD Libraries 

cmplrs-man — MIPS-C Manual Pages 

f77 — MIPS-FORTRAN 

f77-bsd43 — MIPS-FORTRAN 4.3 BSD Libraries 

f77-man — MIPS-FORTRAN Manual Pages 
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selecting subpackages 



You may select all of the above subpackages by answering "y" to the 
following question. If you answer "li" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? n 

When asked if you want to install a subpackage, please answer with one of 
the following: 

y - Yes, you want to install the subpackage 

n - No, you do NOT want to install the subpackage 

1 - List the contents of the subpackage and ask me again 

Install subpackage cmplrs (1 y n) [n] ? n 

Install subpackage cmplrs-bsd43 (1 y n) [n] ? n 

Install subpackage cmplrs-man (1 y n) [n] ? n 

Install subpackage ill (1 y n) [n] ? y 

Install subpackage f77-bsd43 (1 y n) [n] ? y 

Install subpackage f77-man (1 y n) [n] ? y 

Selected subpackages : 

f 77 f77-bsd43 f77-man 
Is this what you want (y n) [y] ? y 



========== setting system clock/calendar ========== 

The current value of the clock is: Mon Jun 3 14:28:09 MDT 19 91 
Is the clock correct (y n) [y] ? y 



========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S" ) prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for f77- preserve not executed. 

No preserve list or findmods list for f77-bsd43- preserve not executed. 
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No preserve list or findmods list for f77-man- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really 
understand the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

========== stripping old links ========== 



Stripping links for subpackage f77... 
Stripping links for subpackage f77-bsd43... 
Stripping links for subpackage f77-man... 

========== extracting files from subpackage archives ========= 



rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Forward spacing the tape... 
Loading subpackage: f77... 
Forward spacing the tape... 
Loading subpackage: f77-bsd43. 
Forward spacing the tape... 
Loading subpackage: f77-man... 
Forward spacing the tape... 
rewinding the tape... 



========== running comply ========== 

running first comply pass . . . 

running second comply pass. . . 

There were no comply messages from the second pass. 

========== doing uncompress Mon Jun 3 14:35:39 MDT 19 91 

========== cleaning up old versions ========== 
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An attempt will now be made to clean up any files left over from previous f~ 
versions of the software which has just been installed. ■ 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for cmplrs- no files restored. 

No preserve list or findmods list for cmplrs-bsd43- no files restored. 

No preserve list or findmods list for cmplrs-man- no files restored. 

No preserve list or findmods list for f77- no files restored. 

No preserve list or findmods list for f77-bsd43- no files restored. 

No preserve list or findmods list for f77-man- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

# 

Now run the install script to compile a small FORTRAN test program: ^ 

# /usr/lib/cnplrs/£772.20/checkinstall 

Compiling and linking test program. . . 
Executing test program. . . 

MIPS-FORTRAN RISCompiler 

The compiler installation completed. 

If the script succeeds the installation has completed successfully, otherwise please call Evans 
& Sutherland for assistance. 



( 
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ES/Dnet Tape 2.2 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 

1) In order for the ES/Dnet installation to work correctly, no ES/Dnet processes should be 
running on the system. To stop Decnet, type /etc/init . d/decnet stop 

2) Insert ES/Dnet 2.2 Tape into the tape drive. 

3) If you are at the xdm login window box, type ALT-F4. 

4) Login as root. 

5) Typecd / 

6) Type /usr/pkg/bin/inst 
Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 

return. . . <CR> 

Rewinding the tape . . . 

Verifying tape id. . . ok 

Extracting packaging information tree... esdnet2.2 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20 

Is the information above correct? (y n) [y] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 

esdnet — ES/Dnet Release 

========== selecting subpackages ========== 
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You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 



Install ALL subpackages (y n) [n] ? y 
========== setting system clock/calendar 



The current value of the clock is: Thu Oct 4 09:43:52 MDT 1990 
Is the clock correct (y n) [y] ? <CR> 



========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for esdnet- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages). For large packages (especially operating 
system packages) , this can be time consuming... 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage esdnet... 

========== extracting files from subpackage archives ========== 



rewinding the tape. . . 
Verifying tape id. . . ok 
Forward spacing the tape. 
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Loading subpackage : esdnet . . . 
Forward spacing the tape... 
rewinding the tape . . . 

========== running comply ========== 

running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass. 

========== doing uncompress Thu Oct 4 09:47:18 MDT 1990 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 
Clean up esdnet .esdnet 2.0 (y n) [n] ? y 
Removing leftover files from esdnet .esdnet 2.0... 

There are no longer any boms present for any subpackages from 
//usr/pkg/lib/esdnet2 .0 version 2.0. This probably indicates that no 
subpackages installed from this package are still present on this system. 

Remove the packaging information tree for this package (y n) [y] ? <CR> 

========== restoring preserved user files ========== 

No preserve list or findmods list for esdnet- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n]? y 

========== installation complete ========== 

Installing the Software Key 

The ES/Dnet license key is normally installed on the system at the factory. If this is a 
customer installed option and/or the /etc/ki_pwd file does not already exist, call the Field 
Service Hotline at 1-800-582-4375 to obtain the key. 

Using any editor, create the file /etc/ki_pwd. Enter the Software Key Number on one line of 
the file, with no spaces before, or between, any of the 18 digits. 
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If you have already installed the LAT Host Services software, this file will already exist. In 
this case, enter the ES/Dnet key before the existing key. 
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Installing the ES/Dnet Software 

Run the installation script located in /usr/etc/esdnet/dna/bin/install.dna The following 
example shows the installation of the ES/Dnet software. The names and numbers used in the 
user responses are for example only. 

Note: The DECnet name is a maximum of six (6) 

characters. Therefore, it may be different from 
your system name. 

ES/Dnet Installation procedure 

In -s /usr/etc/esdnet/dna /usr/etc/dna 

In -s /usr/etc/esdnet/dna/bin/uninstall.dna /usr/etc/uninstall .dna 

In -s /usr/etc/esdnet/dna/bin/install.dna /usr/etc/install .dna 

In -s /usr/etc/esdnet/dna/bin/config.dna /usr/etc/conf ig.dna 

To continue, you must know the DECnet node number and name that has been 

assigned for your host and for a remote node (which has a DECnet database) . 

If you do not know these, press <ENTER> and rerun this installation later 

by executing ' /usr/etc/install .dna' 

Do you wish to continue? [Y/N] 

y 

What is your DECnet node name [keyhole]? 

keyhol f 

What is your DECnet area number [1]? 1 

1 

What is your DECnet node number? 

59 

Defining local node 'keyhol' as DECnet address 1.5 9 

What is the remote DECnet node name? 

rd780b 

What is the remote DECnet area number [1]? 

1 

What is the remote DECnet node number? 

2 

Defining remote node 'rd780b' as DECnet address 1.2 

Saving configuration commands in /usr/etc/esdnet/dna/database/ncp . cmd 

Would you like to see the ncp.cmd file now? [Y/N] 

y 

File Generated By ES/Dnet Version 1.4.3 
Generated On Thu Feb 22 18:24:21 1990 



( 
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! First we should let DECnet know what our local address is: 
Define Executor Address 1.59 
i 

! OK, Now for the Executor Characteristics: 

Set Executor Buffer Size 1461 

Set Hello Timer 15 Seconds 

Set Inactivity Timer 60 Seconds 

Set Incoming Timer 120 Seconds 

Set Outgoing Timer 90 Seconds 

Set Keepalive Timer 300 Seconds 



!Need to know the LAN Device Name 
Set LAN Device Name laO 



And now to define all the nodes : 

Set Node 1.2 Name rd7 80b 

Set Node 1.2 Hardware Address AA-00-04-00-02-04 

Set Node 1.2 Identification rd780b 

Set Node 1.59 Name keyhol 

Set Node 1.59 Hardware Address AA-00-04-00-3B-04 

Set Node 1.59 Identification keyhole 



And now to define all the objects: 

Set Object d_server Number 17 File /usr/etc/dna/bin/d_server 
Set Object mirror Number 25 File /usr/etc/dna/bin/mirror 
Set Object dnamaild Number 27 File /usr/etc/dna/bin/dnamaild 

If you want to know about options that can be used when starting ES/Dnet, 
you can use the "-help" option, i.e.: 

% deknet -help 
Would you like to see this help display now? [Y/N] 
n 

Installation complete 

To start ES/Dnet, type the following: 
/etc/init.d/deknet start 

Downloading the DECnet Database 

To download the DECnet Database, run the following script: /usr/etc/config.dna 
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The script will ask for the username, password, and node name of the VAX/VMS machine. 
The following is a typical example. 

Enter username for remote node 

rbass 

Enter password for remote node 

(password will not be echoed) 

Enter remote node name 

rd780b 

The script will now update the DECnet Database without any more input. 

Username: RBASS 

Password: 

Welcome to VAX/VMS version V5.2 on node RD7 8 0B 

Last interactive login on Thursday, 15-FEB-1990 15:48 

Last non-interactive login on Wednesday, 14-FEB-19 90 19:27 



( 



(RD780b) 
(RD780b) 
(RD780b) 
(RD780b) 
(RD780b) 
(RD780b) 



$ ncp :== $ncp 

$ ncp show known nodes 

Known Node Volatile Summary as of 15-FEB-1990 16:38:35 

Executor node =1.2 (RD780B) 

State = on 

Identification = DECnet-VAX V5.2, VMS V5 . 2 

Node State Active Delay Circuit 

Links 
unreachable 

reachable UNA-0 

reachable UNA-0 

reachable UNA-0 

reachable UNA-0 



( 



1 (PARK) 

3 (TRAIN) 

4 (CAD780) 
30 6 (SPVAX2) 

1.309 (CTVS09) 
(RD7 8 0b) $ logout 

RBASS logged out at 15-FEB-1990 16:38:46.18 
SETHOST for ES/Dnet version 1.4.3 

Remote Session Terminated. Returning control to local system 
Using command file 'test.cmd' 
NCP> ! 

NCP> ! File Generated By CVTNCP on Thu Feb 15 16:41:18 1990 
NCP> ! Released with ES/Dnet Version 1.4.3 
NCP> ! 
NCP> 

NCP> Set Node 1.2 Name RD7 80B 
NCP> Set Node 1.2 ident DECnet-VAX V5.2, VMS V5 . 2 



Next 




Node 




1 


.3 


(TRAIN) 


1 


4 


(CAD780) 


1 


35 


(ESIMSA) 


1 


309 (CTVS09) 



( 
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Loading subpackage : esdnet . . . 
Forward spacing the tape... 
rewinding the tape. . . 

========== running comply ========== 

running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass. 



doing uncompress Thu Oct 4 09:47:18 MDT 1990 ==== 
cleaning up old versions ========== 



An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 
Clean up esdnet .esdnet 2.0 (y n) [n] ? y 
Removing leftover files from esdnet .esdnet 2.0... 

There are no longer any boms present for any subpackages from 
//usr/pkg/lib/esdnet2 .0 version 2.0. This probably indicates that no 
subpackages installed from this package are still present on this system. 

Remove the packaging information tree for this package (y n) [y] ? <CR> 

========== restoring preserved user files ========== 

No preserve list or findmods list for esdnet- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

Installing the Software Key 

The ES/Dnet license key is normally installed on the system at the factory. If this is a 
customer installed option and/or the /etc/ki_pwd file does not already exist, call the Field 
Service Hotline at 1-800-582-4375 to obtain the key. 

Using any editor, create the file /etc/ki_pwd. Enter the Software Key Number on one line of 
the file, with no spaces before, or between, any of the 18 digits. 
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If you have already installed the LAT Host Services software, this file will already exist. In 
this case, enter the ES/Dnet key before the existing key. 
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Installing the ES/Dnet Software 

Run the installation script located in /usr/etc/esdnet/dna/bin/instalLdna. The following 
example shows the installation of the ES/Dnet software. The names and numbers used in the 
user responses are for example only. 

Note: The DECnet name is a maximum of six (6) 

characters. Therefore, it may be different from 
your system name. 

ES/Dnet Installation procedure 

In -s /usr/etc/esdnet/dna /usr/etc/dna 

In -s /usr/etc/esdnet/dna/bin/uninstall .dna /usr/etc/uninstall .dna 

In -s /usr/etc/esdnet/dna/bin/install.dna /usr/etc/install .dna 

In -s /usr/etc/esdnet/dna/bin/conf ig.dna /usr/etc/conf ig.dna 

To continue, you must know the DECnet node number and name that has been 

assigned for your host and for a remote node (which has a DECnet database) . 

If you do not know these, press <ENTER> and rerun this installation later 

by executing ' /usr/etc/install .dna' 

Do you wish to continue? [Y/N] 

y 

What is your DECnet node name [keyhole]? 

keyhol £^ 

What is your DECnet area number [1]? 1 

1 

What is your DECnet node number? 

59 

Defining local node 'keyhol' as DECnet address 1.59 

What is the remote DECnet node name? 

rd780b 

What is the remote DECnet area number [1]? 

1 

What is the remote DECnet node number? 

2 

Defining remote node 'rd780b' as DECnet address 1.2 

Saving configuration commands in /usr/etc/esdnet/dna/database/ncp.cmd 

Would you like to see the ncp.cmd file now? [Y/N] 

y 

File Generated By ES/Dnet Version 1.4.3 
Generated On Thu Feb 22 18:24:21 1990 



( 
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! First we should let DECnet know what our local address is: 
Define Executor Address 1.59 
i 

! OK, Now for the Executor Characteristics: 
Set Executor Buffer Size 1461 
Set Hello Timer 15 Seconds 
Set Inactivity Timer 60 Seconds 
Set Incoming Timer 120 Seconds 
Set Outgoing Timer 90 Seconds 
Set Keepalive Timer 300 Seconds 



!Need to know the LAN Device Name 
Set LAN Device Name laO 



And now to define all the nodes : 

Set Node 1.2 Name rd7 80b 

Set Node 1.2 Hardware Address AA-00-04-00-02-04 

Set Node 1.2 Identification rd7 80b 



Set Node 1.59 
Set Node 1.59 
Set Node 1.59 



Name keyhol 

Hardware Address AA-00-04-00-3B-04 

Identification keyhole 



And now to define all the objects: 

Set Object d_server Number 17 File /usr/etc/dna/bin/d_server 
Set Object mirror Number 25 File /usr/etc/dna/bin/mirror 
Set Object dnamaild Number 27 File /usr/etc/dna/bin/dnamaild 

If you want to know about options that can be used when starting ES/Dnet, 
you can use the "-help" option, i.e.: 

% deknet -help 
Would you like to see this help display now? [Y/N] 
n 

Installation complete 

To start ES/Dnet , type the following: 
/etc/init . d/ deknet start 

Downloading the DECnet Database 

To download the DECnet Database, run the following script: /usr/etc/config.dna 
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The script will ask for the username, password, and node name of the VAX/VMS machine. 
The following is a typical example. 

Enter username for remote node 

rbass 

Enter password for remote node 

(password will not be echoed) 
Enter remote node name 
rd780b 

The script will now update the DECnet Database without any more input . 
Username: RBASS 
Password: 

Welcome to VAX/VMS version V5.2 on node RD780B 
Last interactive login on Thursday, 15-FEB-1990 15:48 
Last non-interactive login on Wednesday, 14-FEB-1990 19:27 

(RD780b) $ 



(RD780b) $ 






(RD780b) $ 






(RD780b) $ 






(RD780b) $ nep 


:— $nep 




(RD780b) $ ncp 


show known nodes 




Known Node Volatile Summary as of 15-FEB-1990 16:38:35 




Executor node = 


1.2 (RD780B) 




State 


= on 




Identification 


= DECnet-VAX V5.2, VMS V5 . 2 




Node 


State Active Delay Circuit 


Next 




Links 


Node 


1.1 (PARK) 


unreachable 




1.3 (TRAIN) 


reachable UNA-0 


1.3 (TRAIN) 


1.4 (CAD780) 


reachable UNA-0 


1.4 (CAD780) 


1.306 (SPVAX2) 


reachable UNA-0 


1.35 (ESIMSA) 


1.309 (CTVS09) 


reachable UNA-0 


1.309 (CTVS09) 



( 



(RD7 80b) $ logout 

RBASS logged out at 15-FEB-1990 16:38:46.18 
SETHOST for ES/Dnet version 1.4.3 

Remote Session Terminated. Returning control to local system 
Using command file 'test.cmd' 
NCP> ! 

NCP> ! File Generated By CVTNCP on Thu Feb 15 16:41:18 1990 
NCP> ! Released with ES/Dnet Version 1.4.3 
NCP> ! 
NCP> 

NCP> Set Node 1.2 Name RD7 80B 
NCP> Set Node 1.2 ident DECnet-VAX V5.2, VMS V5 . 2 



( 
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NCP> Set Node 1.1 Name PARK 
NCP> Set Node 1.3 Name TRAIN 
NCP> Set Node 1.306 Name SPVAX2 
NCP> Set Node 1.30 9 Name CTVS0 9 
NCP> *** EOF *** 
Updating database with changes 
NCP Execution Complete 

Update the running database with the following command: 
/usr/etc/dna/bin/updb 
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AVS3 Tape 2.2 

In the following procedure, system output is shown in typewriter normal font, and user 



( 

responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 

1) Insert AVS3 Tape into the tape drive. 

2) If you are at the xdm login window box, type ALT-F4. 

3) Login as root. 

4) Typecd / 

5) Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 
return . . . <CR> 



Rewinding the tape . . . 

Verifying tape id. . . ok 

Extracting packaging information tree... avs3.0 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 

Machine type: ml20-2 

Is the information above correct? (y n) [y] ? y 

========== checking subpackages ========== 

The following subpackages may be installed: 

avs — AVS3 Release 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to 
select the optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 
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========== setting system clock/calendar ========== 

The current value of the clock is: Tue Jul 23 09:42:54 MDT 1991 
Is the clock correct (y n) [y] ? y 



========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to. continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for avs- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage avs... 

========== extracting files from subpackage archives ========== 

rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage : avs . . . 
Forward spacing the tape... 
rewinding the tape... 



running comply 
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running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass . 

========== doing uncompress Tue Jul 23 09:58:24 MDT 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for avs- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 
========== installation complete ========== 



( 



( 



( 
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NCP> Set Node 1.1 Name PARK 
NCP> Set Node 1.3 Name TRAIN 
NCP> Set Node 1.306 Name SPVAX2 
NCP> Set Node 1.30 9 Name CTVS0 9 
NCP> *** EOF *** 
Updating database with changes 
NCP Execution Complete 

Update the running database with the following command: 
/usr/etc/dna/bin/updb 
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AVS3 Tape 2.2 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 

1) Insert A VS3 Tape into the tape drive. 

2) If you are at the xdm login window box, type ALT-F4. 

3) Login as root. 

4) Typecd / 

5) Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 
return. . . <CR> 

Rewinding the tape . . . 

Verifying tape id. . . ok 

Extracting packaging information tree... avs3.0 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 

Machine type: ml20-2 

Is the information above correct? (y n) [y] ? y 

========== checking subpackages ========== 

The following subpackages may be installed: 

avs — AVS3 Release 

========== selecting subpackages ========== 



C 



( 



You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to 
select the optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 



4 - 70 2.2 Release Notes 



( 



Installation Instructions 



========== setting system clock/calendar ========== 

The current value of the clock is: Tue Jul 23 09:42:54 MDT 1991 
Is the clock correct (y n) [y] ? y 



========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for avs- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage avs... 

========== extracting files from subpackage archives ========== 

rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape. . . 

Loading subpackage : avs . . . 
Forward spacing the tape. . . 
rewinding the tape... 



running comply 
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running first comply pass... 

running second comply pass . . . 

There were no comply messages from the second pass . 

========== doing uncompress Tue Jul 23 09:58:24 MDT 1991 



========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for avs- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 



( 



( 
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LAT Host Services Tape 2.2 
Before Installation 

Before you install LAT Host Services, you must have the following information: 

• The Factory Ethernet Address of your ES V Workstation. Enter the following command 
to get this address: 

/usr/etc/factaddr 

Factory Ethernet Address - - - - - 

The LAT Host Services Software Key Number (18 digits). This license key is normally 
installed on the system at the factory. If the /etc/ki_pwd file does not exist, call the Field 
Service Hodine at 1-800-582-4375 to obtain the key. 

• You will be asked for the System Type (ESV Workstation) and the Factory Ethernet 
Address. 

Software Key Number 

Loading the LAT Host Services Software 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Installation Procedure Begins Here 

You must be logged on the system as root. 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 

1) Insert LAT Host Services 2.2 Tape into the tape drive. 

2) If you are at the xdm login window box, type ALT-F4. 

3) Login as root. 

4) Typecd / 

5) Type /usr/pkg/bin/inst 
Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 

return . . . <CR> 

Rewinding the tape... 

Verifying tape id. . . ok 

Extracting packaging information tree... eslat2.2 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
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Machine type: ml20 

Is the information above correct? (y n) [y] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 

eslat — LAT Host Services 5.5.1 Release 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 



The current value of the clock is: Thu Oct 4 09:59:06 MDT 1990 
Is the clock correct (y n) [y] ? y 



========== verifying single-user mode 



This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for eslat- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 



4 - 74 2.2 Release Notes 



( 



( 



( 



Installation Instructions 



========== stripping old links ========== 

Stripping links for subpackage eslat... 

========== extracting files from subpackage archives ========== 

rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: eslat... 
Forward spacing the tape ... 
rewinding the tape . . . 

========== running comply ========== 

running first comply pass... 

running second comply pass . . . 

There were no comply messages from the second pass. 

========== doing uncompress Wed Jul 31 5:00:17 MDT 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for eslat- no files restored. 
========== cleaning up ========== 

Remove install tools (y n) [n]? y 

========== installation complete ========== 

To start LAT Host Services, enter the following command: 
/etc/init . d/lat start 
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Installing the Software Key g~ 

Using any editor, create the file /etc/ki_j3wd. Enter the Software Key Number on one line of V. 

this file, with no spaces before, or between, any of the 18 digits. 

If you have previously installed the ES/Dnet software, this file will already exist. In this case, 
enter the ES/Dnet key after the existing key. 



( 



c 
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ES/Diskless Node Tape 2.2 

The following instructions should be used for either a Diskless Node installation or a Local 
Server installation. 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 
Before this installation is attempted, make sure you have already installed the ES/os 2.2, and 
ES/PEX Server 2.2 tapes on the Serving machine. (See installation instructions for these par- 
ticular tapes. 

General Notes 

Diskless Node and Local Server machines have very similar installation procedures. For the 
Local Server installation, an SCPU prefix will appear at all user prompts in the instructions 
that follow. 

Diskless Node Notes 

The ES/Diskless Node tape should be installed on an ESV that will be the Serving machine 
for other ESV Diskless Workstations. This Serving machine should already have had the 
ES/os 2.2 and ES/PEX Server 2.2 tapes and any other software options installed prior to at- 
tempting this install. 

Local Server Machine Notes 

The ES/Diskless Node tape should be installed on the SCPU (which is the "Serving" CPU). 
This Serving CPU should already have had the ES/os 2.2 and ES/PEX Server 2.2 tapes and 
any other software options installed prior to attempting this install. 

Disk Space Requirements 

The files on tapes used require approximately 400 megabytes of disk space. This is due to 
the fact that the ES/os 2.2 tape and the ES/PEX Server 2.2 tapes are installed again during 
this procedure (but in a different location on the disk). 

Items needed for a Diskless Node/Local Server Installation: 

♦ ES/Diskless Node 2.2 tape 

♦ ES/os 2.2 tape 

♦ ES/PEX Server 2.2 tape 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Installation Begins Here 
1) Login as root. 
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2) Insert the ES/Diskless Node distribution tape into the ESV Serving machine or the Local 
Server machine. 

3) Typecd / 

# sync; sync 

# telinit 

# 

INIT: New run level: 

Miniroot shutdown 

E&S CPU Board MIPS Monitor Version 5.00 MIPS OPT Mon Feb 18 15:00:28 MST 

1991 

Copyright 1988, MIPS Computer Systems Inc., All Rights Reserved 

Memory size: 33554432 (0x2000000) bytes 

Icache size: 65536 (0x10000) bytes 

Dcache size: 65536 (0x10000) bytes 

» boot -f dkis(, ,8) sash 

138896+27152+175024 entry: 0xa0480000 

MIPS Standalone shell Version 5.00 MIPS OPT Mon Feb 18 10:49:00 MST 1991 

sash» boot -f dkis()/unix initarg=s 

869264+103616+894624 entry: 0x80021000 

CPU: MIPS R3000 Processor Chip Revision: 3.0 

FPU: MIPS R3010 VLSI Floating Point Chip Revision: 4.0 

ES/os Release 2.2 ESV Version R_100 

Total real memory = 33554432 

Available memory = 31170560 

abminit : ARS/HIC not present. 

arsinit: ARS/HIC not present. 

installing VME vector: addr 0x8007FBlC ipl 1, vec 0x1 unit 

Root fstype ffs 

Available memory = 62386176 

Checking root file system () if necessary. 



( 



INIT: SINGLE USER MODE 
TERM: (esconsole) <CR> 
# fsck.ffs /dev/usr 

** /dev/usr 

** Last Mounted on /usr 

** Phase 1 - Check Blocks and sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 
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** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl Group 

6201 files, 109993 used, 431042 free (1946 frags, 53637 blocks, 0.4% frag) 

4) Type the following: 

# mount -a 

# mkdir -p /usr/diskless/dl_root 

# /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? /usr/diskless/dl_root 

Please mount the (first, if multiple tapes) distribution tape, then press 
return . . . <CR> 
Rewinding the tape . . . 
Verifying tape id. . . ok 

Extracting packaging information tree... umips-diskless2 .2 

Installation Information: 

Packages will be read in from the local Q2 4 tape device. 
Machine type: ml20-x 

Is the information above correct? (y n) [y] ? y 

========== checking subpackages ========== 

The following subpackages may be installed: 

droot — Diskless root files 
dusr — Diskless usr files 
dvar — Diskless var files 



========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n]? y 

========== setting system clock/calendar ========== 
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The current value of the clock is: Tue Jun 25 12:23:32 PDT 1991 
Is the clock correct (y n) [y] ? y 



========== verifying single-user mode === 

The system is in a single-user run level. 
========== preserving local files ======= 



No preserve list or findmods list for droot- preserve not executed. 
No preserve list or findmods list for dusr- preserve not executed. 
No preserve list or findmods list for dvar- preserve not executed. 



verifying disk space === 



Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming... 

There is enough space. 

========== stripping old links ========== 



Stripping links for subpackage droot. 
Stripping links for subpackage dusr.. 
Stripping links for subpackage dvar.. 



extracting files from subpackage archives 



rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape. 

Loading subpackage: droot 

Forward spacing the tape. 

Loading subpackage: dusr. 

Forward spacing the tape. 

Loading subpackage: dvar. 

Forward spacing the tape, 
rewinding the tape . . . 
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========== running comply ========== 

running first comply pass . . . 

running second comply pass... 

There were no comply messages from the second pass. 

========== doing uncompress Tue Jun 25 12:25:31 PDT 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for droot- no files restored. 
No preserve list or findmods list for dusr- no files restored. 
No preserve list or findmods list for dvar- no files restored. 

========== running conversion scripts ========== 

========== droot. conversion Tue Jun 25 12:25:41 PDT 1991 ========== 

Diskless Conversion... 

Filesystem Type kbytes use avail %use Mounted on 
/dev/usr ffs 483820 300583 183237 62% /usr 

Kbytes free on the server disk: 183237 

WARNING! When asked whether or not you want to perform the space check 
please answer "yes" 

Press [RETURN] to continue: <CR> 

You should now install ES/os. Put the ES/os tape 1 in the drive. 

Software package installation 

Please mount the (first, if multiple tapes) distribution tape, then press 
return. . . <CR> 
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Rewinding the tape... 
Verifying tape id. . . ok 

Extracting packaging information tree... ESos2.2 

========== checking subpackages ========== 

The following subpackages may be installed: 

root — ES/os Standard Root Filesystem 

usr — ES/os Standard /usr Filesystem 

usr__help — ES/os Standard /usr help facilities 

usr_dvlp — ES/os Standard /usr Development files (header files & 

libraries) 

usr_terms — ES/os Standard /usr Miscellaneous Terminal descriptions 

cmplrs — MIPS-C Compiler 

cmplrs-bsd43 — MIPS-C 4.3 BSD Include Files and Libraries 

man — ES/os Utilities and Administration Manual Pages 

man_misc — ES/os SPP Manual Pages 

bsd43 — ES/os 4.3 BSD Utilities 

bsd43_troff — ES/os 4.3 BSD Troff Utilities and Libraries 

bsd43_dvlp — ES/os 4.3 BSD Include Files and Libraries 

reconfig — Kernel Binary Reconfiguration Components 

emacs — emacs 

posix — ES/os POSIX P1003.1 Include Files, Commands and Libraries 

uucp — UUCP 

sees — SCCS 

news_readers — News Readers 

games — Games 

mh — mh 



( 



========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to 
select the optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? n -> See Configuration Information - 
page 4-2 

When asked if you want to install a subpackage, please answer with one of 
the following: 

y - Yes, you want to install the subpackage 

n - No, you do NOT want to install the subpackage 

1 - List the contents of the subpackage and ask me again 
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Subpackage root will be installed 
Subpackage ml20-l will be installed 
Subpackage usr will be installed 

Install subpackage usr_help (1 y n) [n] ? n 

Install subpackage usr_dvlp (1 y n) [n] ? n 

Install subpackage usr_terms (1 y n) [n] ? n 

Install subpackage cmplrs (1 y n) [n]? y 

Install subpackage cmplrs-bsd43 (1 y n) [n] ? n 

Install subpackage man (1 y n) [n] ? y 

Install subpackage bsd43 (1 y n) [n] ? y 

Install subpackage bsd43_troff (1 y n) [n] ? n 

Install subpackage bsd43_dvlp (1 y n) [n] ? n 

Install subpackage reconfig (1 y n) [n] ? n 

Install subpackage emacs (1 y n) [n] ? n 

Install subpackage posix (1 y n) [n] ? n 

Install subpackage uucp (1 y n) [n] ? n 

Install subpackage sees (1 y n) [n]? n 

Install subpackage news_readers (1 y n) [n] ? n 

Install subpackage games (1 y n) [n] ? n 

Install subpackage mh (1 y n) [n] ? n 

Selected subpackages : 

root ml2 0-l usr cmplrs man bsd43 
Is this what you want (y n) [y] ? y 



preserving local files 



Running preserve -s for subpackage root... files preserved. 

No preserve list or findmods list for ml20-3- preserve not executed. 

Running preserve -s for subpackage usr. . . files preserved. 

No preserve list or findmods list for cmplrs- preserve not executed. 

No preserve list or findmods list for man- preserve not executed. 

No preserve list or findmods list for bsd43- preserve not executed 



========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 
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There is enough space. 
========== stripping old links 



Stripping links for subpackage root . . . 
Stripping links for subpackage usr. . . 
Stripping links for subpackage cmplrs... 
Stripping links for subpackage man... 
Stripping links for subpackage bsd.43... 



( 



extracting files from subpackage archives 



rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: root.. 
Forward spacing the tape.. 
Forward spacing the tape.. 
Loading subpackage: usr... 
Forward spacing the tape.. 
Loading subpackage : cmplrs 
Forward spacing the tape.. 
Loading subpackage: man... 
Forward spacing the tape.. 
Loading subpackage: bsd43. 
Forward spacing the tape., 
rewinding the tape . . . 



( 



========== running comply ========== 

running first comply pass... 
running second comply pass... 

There were no comply messages... 

========== doing uncompress Tue Jun 25 13:59:02 PDT 1991 

uncompress usr/bin/acctcom. Z 
uncompress usr/bin/admin. Z 
uncompress usr/bin/at.Z 

. (Uncompresses Occur Here...) 

uncompress usr/new/mh/vmh. Z 
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uncompress usr/new/mh/whatnow.Z 
uncompress usr/new/mh/whom.Z 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

Type y y' to any Clean up prompts. 

========== restoring preserved user files ========== 

Running preserve -r for subpackage root . . . 

Running preserve -r for subpackage usr... 

No preserve list or findmods list for cmplrs- no files restored. 

No preserve list or findmods list for man- no files restored. 

No preserve list or findmods list for bsd43- no files restored. 

========== running conversion scripts ========== 

========== root. f stab Tue Jun 25 14:09:56 PDT 1991 ========== 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

Are you going to use ES/PEX Server 2.2 on any of the clients? (y n) [y] ? y 

You should now install ES/PEX Server 2.2. Put the ES/PEX Server tape in the 
drive. <CR> 

Software package installation 

Please mount the (first, if multiple tapes) distribution tape, then press 
return . . . <CR> 
rewinding the tape... 
Verifying tape id. . . ok 

Extracting packaging information tree... pexs2.2 
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========== checking subpackages ========== 

The following subpackages may be installed: 

executables_s — PEX 2.2 Executable Release 
library_s — PEX 2.2 Library Release 
pexs-man — PEX 2.2 Man Page Release 
fstest — fstest Release 
xclients_s — PEX 2.2 XClients Release 
pexs-man-unformat — Unformatted Man Page Release 
demo_s — Demo_s Release 
contrib s — X Contributed clients 



========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? — > See Configuration Information 

========== setting system clock/calendar ========== 

The current value of the clock is: Fri Mar 22 16:37:04 MST 1991 
Is the clock correct (y n) [y] ? y 



C 



verifying single-user mode 



This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

Running preserve -s for subpackage executables_s . . . 2 files preserved. 
No preserve list or findmods list for library_s- preserve not executed. 
No preserve list or findmods list for pexs-man- preserve not executed. 
No preserve list or findmods list for fstest- preserve not executed. 
No preserve list or findmods list for xclients_s- preserve not executed. 
No preserve list or findmods list for pexs-man-unformat- preserve not 
executed. 

No preserve list or findmods list for demo_s- preserve not executed. 
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No preserve list or findmods list for contrib_s- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space . 

========== stripping old links ========== 

Stripping links for subpackage executables_s . . . 

Stripping links for subpackage library_s . . . 

Stripping links for subpackage pexs-man... 

Stripping links for subpackage f stest . . . 

Stripping links for subpackage xclients_s . . . 

Stripping links for subpackage pexs-man-unf ormat . . . 

Stripping links for subpackage demo_s . . . 

Stripping links for subpackage contrib_s... 



extracting files from subpackage archives 



rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: executables_s . . . 

Forward spacing the tape... 

Loading subpackage: library_s . . . 

Forward spacing the tape... 

Loading subpackage: pexs-man... 

Forward spacing the tape... 

Loading subpackage: f stest .. . 

Forward spacing the tape... 

Loading subpackage: xclients_s . . . 

Forward spacing the tape... 

Loading subpackage: pexs-man-unf ormat . 

Forward spacing the tape... 

Loading subpackage : demo_s . . . 

Forward spacing the tape... 
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Loading subpackage: contrib_s... 
Forward spacing the tape. . . 
rewinding the tape. . . 



========== running comply ========== 

running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass. 



========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

NOTE: These messages appear if you have a previous version 
of ES/PEX Server installed on your system. 

Clean up pexs .executables_s 2.0 (y n) [n]? y 
Clean up pexs . libra ry_s 2.0 (y n) [n] ? y 
Clean up pexs .pexs -man 2.0 (y n) [n] ? y 
Clean up pexs.fstest 2.0 (y n) [n] ? y 

There are no longer any boms present for any subpackages from 
//usr/pkg/lib/pexs2 .0 version 2.0. This probably indicates that no 
subpackages installed from this package are still present on the system. 

Remove the packaging information tree for this package (y n) [y] ? y 

========== restoring preserved user files ========== 

Running preserve -r for subpackage executables_s . . . 

No preserve list or findmods list for library_s- no files restored. 

No preserve list or findmods list for pexs-man- no files restored. 

No preserve list or findmods list for fstest- no files restored. 

No preserve list or findmods list for xclients_s- no files restored. 

No preserve list or findmods list for pexs-man-unf ormat- no files restored. 

No preserve list or findmods list for demo_s- no files restored. 

No preserve list or findmods list for contrib s- no files restored. 



( 



== running conversion scripts ===== 



( 
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========== pexs-man. conversion Tue Jun 25 15:09:45 PDT 1991 ========= 

Manpage Conversion... 

x_man exists 
P_man exists 

Done. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== doing uncompress Tue Jun 25 15:09:02 PDT 1991 ========== 

========== installation complete ========== 

Fixing up all the directories and links... 

mv: posix: No such file or directory 

rmdir: usr/new/lib/emacs/lock: Directory does not exist 

In: Symbolic link ../../../.. /var/lib/emacs/lock to 

usr/new/lib/emacs/lock: No such file or directory 

Doing comply for ES/os 2.2 files and directories... 

Comply Pass 1... done. 
Comply Pass 2... done. 

Doing comply for ES/PEX 2.2 files and directories... 

Comply Pass 1... done. 
Comply Pass 2... done. 

No comply errors . 

Building diskless database directory and files . . . 
Done . 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 
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# cd /usr/disklessDB 

# . /client . setup 

MIPS diskless client installation 

Operation (add clone modify move del) [add] ? add 

Is this client a 25Mhz CPU? (y n) [y] ? n 

New Client Machine Name? []? toddler (for example only) 

Is this client the gcpu of an LS system (y n) [n] ? y 

Enter toddler's inet address [130 . 187 .100 .xx] ? 130.187.100.50 

Adding toddler to /etc/hosts. 

Mode (master slave client none) [none]? none 

Note: Your swap space size should be twice the physical memory of the 
Client . 

Swap Space Size [32M] ? 32M 

Client Root Directory [/usr/diskless/clients/toddler] ? <CR> 
Client Swap File Directory [/usr/diskless/clients/toddler]? <CR> 
Client Dump File Directory [/usr/diskless/clients/toddler]? <CR> 
Read Only usr Directory [/usr/diskless/dl_usr] ? <CR> 

Building environment for toddler. 
Copying root directory... done. 
Copying var directory... done. 
Creating swap file... done. 
Building devices... done. 
Copying /etc/hosts for toddler 
Creating etc/fstab for toddler 
Creating etc/local_hostname for toddler 
Adding toddler to /etc/bootparams 
Adding toddler to /usr/etc/exports 

Running /usr/etc/exportf s . . . 
exported /usr/diskless/dl_usr 
exported /usr/diskless/clients/toddler 
done . 
Creating link in /tftpboot for toddler 

Starting /etc/rpc .bootparamd. . . done. 
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# sync; sync 

# telinit 

» auto (follow normal boot procedure at this point) 

Autoboot: waiting to load lcs () tftboot/gcpu (CTRL-C to abort, RETURN to 
expedite) <CR> 

For Local Server systems, you will need to boot the second CPU the same as above. 

Installation is now complete. 
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ES/Kodak Printer Tape 2.2 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

Installation Procedure Begins Here 

Caution: It is recommended that YOU be the only user 
logged onto the machine while loading this 
software. 

1) Insert ES/Kodak Printer Tape 2.2 into the tape drive. 

2) If you are at the xdm login window box, type ALT-F4. 

3) Login as root. 

4) Typecd / 

5) Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 
return . . . <CR> 
Rewinding the tape . . . 
Verifying tape id. . . ok 

Extracting packaging information tree... kodak2.2 

Installation Information: 

Packages will be read in from the local Q2 4 tape drive. 
Machine type: ml20-l 

Is the information above correct? (y n) [y] ? y 
========== checking subpackages ========== 

The following subpackages may be installed: 
kodak — Kodak 2.2 Release 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 
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Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 

The current value „of the clock is: Wed Apr 10 13:25:26 MDT 1991 
Is the clock correct (y n) [y] ? y 

========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S" ) prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for kodak- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space . 

========== stripping old links ========== 

Stripping links for subpackage kodak... 

========== extracting files from subpackage archives ========== 

rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 
Loading subpackage: kodak... 
Forward spacing the tape... 
rewinding the tape... 
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running comply 



running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass. 

========== doing uncompress Wed Apr 10 13:26:20 MDT 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for kodak- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n]? y 

========== installation complete ========== 

To configure the SCSI printer device for the Kodak Printer, type the following while logged 
in as root: 

mknod /dev/scsi /printer c 16 80; chmod 666 /dev/scsi/printer 

Installation is complete 



( 
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Visix Looking Glass Option 

In the following procedure, system output is shown in typewriter normal font, and user 
responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return <CR>. 

1) Insert Visix Looking Glass tape into tape drive. 

2) Login as root. 

3) Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 
return . . . <CR> 
Rewinding the tape . . . 
Verifying tape id. . . ok 

Extracting packaging information tree... lookglass2.1 

Installation Information: 

Packages will be read in from the local Q2 4 tape drive. 
Machine type: ml20-2 

Is the information above correct? (y n) [y] ? y 

========== checking subpackages ========== 

The following subpackages may be installed: 

lookglass — Visix Looking Glass 2.1 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n]? y 

========== setting system clock/calendar ========== 

The current value of the clock is: Fri Sep 13 11:03:08 MDT 1991 
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Is the clock correct (y n) [y] ? y 

========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n]? y 

========== preserving local files ========== 

No preserve list or findmods list for lookglass- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y]? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming. . . 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage lookglass... 

========== extracting files from subpackage archives ========== 

rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape. . . 

Loading subpackage: lookglass... 
Forward spacing the tape. . . 
rewinding the tape... 



========== running comply ==== 

running first comply pass... 
running second comply pass... 
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There were no comply messages from the second pass. 

========== doing uncompress Fri Sep 13 11:06:21 MDT 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for lookglass- no files restored. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

Run the Installation Shell Script 

1) Typecd /usr/visix/install 

2) Type . /lg_install 

Looking Glass (C) Copyright 1988-1991, Visix Software Inc. 

You can choose the standard installation or the custom installation. The 
standard installation procedure links the proper Looking Glass file into 
the standard system directories (/etc and /usr/bin) . 

The custom installation procedure allows you to specify where files are to 
be linked, and allows you to handle non-standard systems. 

If you are not sure which to do, try the standard installation. If you plan 
to install Looking Glass on only one machine and have other machines access 
it over the network, you will probably want to use the custom installation 
to a unique directory location. 

Do you want to perform the standard installation procedure? [y/n/q] y 

Logging application directories to /etc/ visix. apps .. . 

Creating executable shell script files... 
lg (shell script) 
lg_jpause (shell script) 
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lg_convert (shell script) 
fss (shell script) 
build_db (shell script) 
db_build (shell script) 
db_remove (shell script) 
assigndef (shell script) 
ftc (shell script) 
vice (shell script) 
icon_merge (shell script) 
icon_convert (shell script) 
vis (shell script) 
vls_add (shell script) 
vls_del (shell script) 
vls_where (shell script) 

Linking ^English_United. States__ISO. 8859 . l f version files., 



Assigning access permissions for data files . 

lg.hlp 

help_images . vr 

lg_icons .vr 

look.vr 

icons .sym 

LG_rulebase 

exclude . lgdb 

Makefile 

records .sym 

ftdefs.h 

records .sym 

class .ftc 

data .ftc 

dev. ftc 

gen. ftc 

prog. ftc 

ftdefs .loch 

class .loc. ftc 

data .loc. ftc 

dev. loc. ftc 

gen. loc. ftc 

prog. loc. ftc 

helpwins . vr 

colors 

system. vr 

vuistrs . vr 
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lang_time 
lang_specs 
vice.vr 
vice. hip 

Duplicating data files... 

Installation complete. 

Activate the License Keys 

1) At the system prompt, enter: 

/usr/bin/vls__add 

creating new data file Vusr/visix/vls/def ault/vls .data' 
enter license number to add :<enter 1st number here> 
enter license number to add :<enter 2nd number here> 
enter license number to add:<CR> 

database file Vusr/visix/vls/default/vls .data' updated ... 
run % vls -1' to check validity of license numbers 

2) Once the program has exited, verify that the keys were entered correctly by entering: 

vis -1 

3) Check the list of license keys. Make sure that the anticipated number of users and CPUs 
are able to run Looking Glass. If the numbers were entered correctly, go to next proce- 
dure. 

If NOT, you will need to delete the incorrect key(s). Do this by typing the following: 

vls^del 
Enter the mis-typed key and press <CR>, then exit the script with another <CR>. 

Authorize License Server Host Machines 

This step is only necessary if you intend to run Looking Glass and the License Server on 
different machines. 

1) Typecd /usr/visix/vls /default 

2) Edit the file vls.hosts using a text editor (i.e., emacs, -nw, or vi). 

3) Add as the first line of the file the hostname of the system which is running the Visix 
License Server. 

4) Save the file vls.hosts with the above changes. 

5) Log out of root. 

Starting Looking Glass for the First Time 

1) Login to your user account while in the root screen (blue screen). 
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2) Add the following lines to your .Xdefaults file in your home directory using a text editor 
of choice (i.e., emacs, -nw, or vi): 



( 



Under the Mwm defaults 



Mwm*clientAutoPlace: False 
Mwm*positionIsFrame: False 

3) Start the X Server (i.e., xinit, startesvx, xdm) 

4) Run the following script while in your home directory logged on as you, by typing: 

/usr/bin/newLGuser.sh <your username> 

===== Installing <your usernazae> 
===== Finished with <your username> 
This script sets up a default factory environment for Looking Glass to use. 



Caution: If your system is running "Yellow Pages," you 
will need to copy a file as follows before typing 
the commands in steps 5 and 6. 

a) Type cd /etc 

b) Type cp vis , conf . lookglass vis , conf 

Failure to do this will cause Looking Glass to 
appear to hang when you type lg & 



C 



5) Type vis 

6) Typelg & 

The software will start with initial preset defaults (i.e., colors, window placement, etc.). 
Any changes you make to these settings during your session will be saved automatically 
in the /lg file in your home directory. Refer to the tutorial for information on changing 
these defaults. 

Automatic Startup of Looking Glass 

If you would like Looking Glass to startup at login every time, add the following lines to both 
your .xsession and .xinitrc files located in your home directory:* 

vis 

lg & 

* If these files don't exist in your home directory, you may copy sample .xsession and .xini- 
trc files (as well as others) from the directory /usr/src/samples. Type is -a to see these 
files. These files already have the new Looking Glass commands inserted. 
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####################### xterm ########################################### 

# 

xterm* jumpScroll : 

xterm*scrollBar : 

xterm*saveLines : 

xterm*font : 

xterm*TitleBar : 

xterm*Deiconif yWarp : 

#ifdef COLOR 

xterm*Background : 

xterm*Foreground : 

xterm*border : 

xterm*cursorColor : 

xterm*pointerColor : 

#endif 

# 

####################### err 

# 

emacs*geometry : 

emacs .Title: 

emacs . TitleBar : 

emacs *Font : 

emacs *BitMapIcon : 

#ifdef COLOR 

#emacs *Background : 

#emacs*Foreground: 

emacs*Background: 

emacs *Foreground : 

emacs* foreground: 

emacs*cursorColor : 

#endif 

# 

####################### xlogo ########################################### 

# 

#ifdef COLOR 

xlogo *Background: 

xlogo *Foreground: 

#endif 

# 

####################### xload ########################################### 



on 

on 

400 

6x13 

on 

on 

#00294d 
tffffff 
#ffl493 
#ffff00 
#ff0000 



###########################################■ 

81x35+0+0 

Emacs 

on 

9x15 

on 

#00294d 
#ffffff 
#102030 

#ffc080 
#ffffff 
#ffff00 



#00294d 
#ffff00 
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# 

#ifdef COLOR 

xload*highlight: #ffff00 

xload*Background: #f4a460 

xload*Foreground: #000000 

#endif 

# 

####################### oclock ########################################## 

# 

#ifdef COLOR 

Clock*Background: #f4a460 

Clock*BorderColor: #002 94d 

Clock*hour: black 

Clock* jewel: black 

Clock*minute: black 

#endif 

# 

####################### xclock ########################################## 

# 

#ifdef COLOR 

xclock*Background: #000000 

xclock*Border: #ffffff 

xclock*Foreground: #ffff00 

xclock*Hands: #ffffff 

#endif 

xclock*Mode: analog 

xclock*Update: 1 

# 

####################### xbiff ########################################### 

# 

xbif f *geometry: 80x80 

#ifdef COLOR 

xbiff*Border: #ffffff 

xbiff*Update: 1 

xbiff*Background: #b0ffff 

xbiff*Foreground: #902030 

#endif 

# 

####################### xclipboard ###################################### 

# 

#ifdef COLOR 

xclipboard*form*quit*Background: #00294d 

xclipboard*form*quit*Foreground: #f f f f 

xclipboard*form*delete*Background: #0 02 94d 
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#ffffOO 
#00294d 
#ffffOO 
#00294d 
#ffffOO 
#00294d 
#ffffOO 
#f4a460 
#000000 



xclipboard*form*delete*Foreground: 

xclipboard*f orm*new*Background : 

xclipboard*f orm*new*Foreground : 

xclipboard*form*next*Background: 

xclipboard*form*next*Foreground: 

xclipboard*form*prev*Background: 

xclipboard*form*prev*Foreground: 

xclipboard*form*text*Background: 

xclipboard*form*text*Foreground: 

#endif 

XC1 ipbo a rd. geometry: 

# 

####################### xfontsel 

# 

XFontSel*ShapeStyle : 

#ifdef COLOR 

XFontSel*quitButton*Background: 

XFontSel*quitButton*Foreground : 

XFontSel*ownButton*Background : 

XFontSel*ownButton*Foreground: 

XFont Sel*commandBox . Background : 

XFontSel*countLabel .Background: 

#XFontSel*fieldBox. Background: 

XFont Sel*fieldBox*Background: 

XFont Sel * f ontName *Background : 

XFontSel*sampleText*Background: 

#endif 

# 

####################### xeyes ########################################### 

# 

#ifdef COLOR 

XEyes *Foreground : 

XEyes *Background : 

xeyes*outline : 

xeyes *center : 

XEyes*BorderColor : 

#endif 

# 

####################### xfd 

# 

Xfd*ShapeStyle: 

#ifdef COLOR 

Xf d*Background : 

Xf d*Foreground : 



280x250+578+173 

######################################## 

Oval 

#00294d 
#ffff00 
#00294d 
#ffff00 
#f4a460 
#f4a460 
#f4a460 
#f4a460 
#f4a460 
#f4a460 



#00294d 
#f4a460 
firebrick 
grey 80 
black 



############################################ 

Oval 

#f4a460 
#000000 
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Xfd*quit .Background: #00294d 

Xfd*quit .Foreground: #ffff00 

Xfd*prev. Background: #00294d 

Xfd*prev. Foreground: #ffff00 

Xfd*next. Background: #00294d 

Xf d*next . Foreground : #f f f f 

Xfd*select*Background: #f4a460 

Xfd*metrics*Background: #f4a460 

Xfd*range*Background: #f4a460 

Xfd*start*Background: #f4a460 

#endif 

# 

####################### xman ############################################ 

# 

xman*ShapeStyle: Oval 

#ifdef COLOR 

xman*manualBrowser*search*manualPage*Background: #f 4a4 60 

xman*manualBrowser*search*manualPage*Foreground : #000000 

xman*manualBrowser*search*apropos*Background: #f 4a4 60 

xman*manualBrowser*search*apropos*Foreground: #0 0000 

xman*manualBrowser*search*cancel*Background: #f 4a4 60 

xman*manualBrowser*search*cancel*Foreground: #000000 

xman*manualBrowser*search*value*Background: #f 4a4 60 

xman*manualBrowser*search*value*Foreground: #000000 

xman*manualBrowser*likeToSave*yes*Background: #f 4a4 60 

xman*manualBrowser*likeToSave*yes*Foreground: #0 000 

xman*manualBrowser*SimpleMenu*Background: #8blala 

xman*manualBrowser*SimpleMenu*Foreground: #f f f f 00 

xman*topLabel*Background: #f 4a4 60 

xman*manualBrowser*Background: #0 02 94d 

xman*manualBrowser*Foreground: #f f f f f f 

xman*helpButton*Background: #00294d 

xman*helpButton*Foreground: #f f f f 00 

xman*quitButton*Background: #00294d 

xman*quitButton*Foreground: #f f f f 00 

xman*manpageButton*Background: #00.2 9 4d 

xman*manpageButton*Foreground: #f f f f 00 

xman*manualPage*Background: #0 02 94d 

xman*manualPage*Foreground: #f f f f 00 

xman*apropos*Background: #002 94d 

xman*apropos*Foreground: #ffff00 

xman*displayManualPage*Background: #00294d 

xman*displayManualPage*Foreground : #f f f f f f 

xman*displayDirectory*Background: #8blala 
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xman*displayDirectory*Foreground: #f f f f f f 

#endif 

xman*pagesize: 520x765+0+0 

xman*bothShown: true 

# 

####################### X calc ########################################### 

# 

xcalc *geometry: +885+5 

#ifdef COLOR 

xcalc*Foreground: #000000 

xcalc*Background: #f4a460 

xcalc*bevel. background: #00294d 

xcalc*screen*background: #000000 

xcalc*screen*foreground: #ffffff 

xcalc* screen*DEG* foreground: #f f f f 00 

xcalc*screen*RAD*foreground: #ff f fOO 

xcalc *screen*GRAD*foreground: #f f f fOO 

xcalc* screen* INV*foreground: #ff ffOO 

xcalc *screen*P* foreground: #f f f f 00 

xcalc*ti.buttonl*background: #00294d 

xcalc*ti.button2*background: #00294d 

xcalc*ti.button3*background: #002 94d 

xcalc*ti.button4*background: #00294d 

xcalc*ti.button5*background: #00294d 

xcalc*ti.button6*background: #00294d 

xcalc*ti.button7*background: #00294d 

xcalc*ti.button8*background: #00294d 

xcalc*ti.button9*background: #00294d 

xcalc*ti.buttonlO*background: #00294d 

xcalc*ti.buttonll*background: #00294d 

xcalc*ti.buttonl2*background: #00294d 

xcalc*ti.buttonl3*background: #00294d 

xcalc*ti.buttonl4*background: #00294d 

xcalc*ti .buttonl5*background: #00294d 

xcalc*ti.buttonl6*background: #00294d 

xcalc*ti.buttonl7*background: #00294d 

xcalc*ti.buttonl8*background: #00294d 

xcalc*ti.buttonl9*background: #00294d 

xcalc*ti.button20*background: #00294d 

xcalc*ti.button21*background: #00294d 

xcalc*ti.button22*background: #00294d 

xcalc*ti.button23*background: #00294d 

xcalc*ti.button24*background: #00294d 

xcalc*ti.button25*background: #00294d 
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xcalc*ti.button26*background: #00294d 
xcalc*ti.button27*background: #00294d 
xca lc*ti. but ton2 8 background: #00294d 
xcalc*ti.button29*background: #00294d 
xcalc*ti.button30*background: #00294d 
xcalc*ti.button31*background: #00294d 
xcalc*ti.button32*background: #00294d 
xcalc*ti.button33*background: #00294d 
xcalc*ti.button34*background: #00294d 
xcalc*ti.button35*background: #00294d 
xcalc*ti.button36*background: #00294d 
xcalc*ti.button37*background: #00294d 
xcalc*ti.button38*background: #00294d 
xcalc*ti.button39*background: #00294d 
xcalc*ti.button40*background: #00294d 
xcalc*ti .buttonl*f oreground: #f f f f 00 
xcalc*ti ,button2*f oreground: #f f f f 00 
xcalc*ti .button3*f oreground: #f f f f 00 
xcalc*ti .button4*f oreground: #f f f f 00 
xcalc*ti .button5*f oreground: #f f f f 00 
xcalc*ti .button6*f oreground: #f f f f 00 
xcalc*ti .button7*f oreground: #f f f f 00 
xcalc*ti .button8*f oreground: #£f f f 00 
xcalc*ti .button9*f oreground: #f f f f 00 
xcalc*ti .buttonl0*f oreground: #f f f f 00 
xcalc*ti .buttonll*f oreground: #f f f f 00 
xcalc*ti .buttonl2*f oreground: #f f f f 00 
xcalc*ti .buttonl3*f oreground: #f f f f 00 
xcalc*ti .buttonl4*f oreground: #f f f f 00 
xcalc*ti.buttonl5*f oreground: #ffff00 
xcalc*ti .buttonl6*f oreground: #f f f f 00 
xcalc*ti.buttonl7*foreground: #ffff00 
xcalc*ti.buttonl8*f oreground: #ffff00 
xcalc*ti.buttonl9*foreground: #ffff00 
xcalc*ti.button20*f oreground: #ffff00 
xcalc*ti.button21*f oreground: #ffff00 
xcalc*ti ,button22*f oreground: #f f f f f f 
xcalc*ti .button23*f oreground: #f f f f f f 
xcalc*ti.button24*f oreground: #ffffff 
xcalc*ti .button25*f oreground: #f f f f 00 
xcalc*ti.button26*f oreground: #ffff00 
xcalc*ti.button27*f oreground: #ffffff 
xcalc*ti .button28*f oreground: #f f f f f f 
xcalc*ti .button29*f oreground: #f f f f f f 
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xcalc*ti.button30*foreground: 
xcalc*ti .button31*f oreground: 
xcalc*ti ,button32*f oreground: 
xcalc*ti .button33*f oreground: 
xcalc*ti ,button34*f oreground: 
xcalc*ti .button35*f oreground: 
xcalc*ti.button36*f oreground: 
xcalc*t i . button37 *f oreground : 
xcalc*ti.button38*f oreground: 
xcalc*ti .button39*f oreground: 
xcalc*t i . button4 *f oreground : 
# 

# HP button settings 
# 

xcalc*hp .buttonl*background: 
xcalc *hp . button2 ^background : 
xcalc*hp . button3 *background : 
xcalc*hp . button4 *background : 
xcalc*hp.button5*background: 
xcalc*hp.button6*background: 
xcalc*hp . button7 *background : 
xcalc*hp . button8 *background : 
xcalc*hp.button9*background: 
xcalc*hp. buttonl O*background: 
xcalc*hp . buttonl 1 ^background : 
xcalc*hp . buttonl2 background : 
xcalc*hp.buttonl3*background: 
xcalc*hp.buttonl4*background: 
xcalc*hp.buttonl5*background: 
xcalc*hp . buttonl 6*background : 
xcalc*hp.buttonl7*background: 
xcalc *hp . buttonl 8 background : 
xcalc*hp . buttonl 9 background : 
xcalc *hp . butt on2 background : 
xcalc*hp . button2 1 ^background : 
xcalc*hp . button22 *background : 
xcalc*hp.button23*background: 
xcalc*hp . button2 4 background : 
xcalc*hp.button25*background: 
xcalc*hp . button2 6 *background : 
xcalc*hp . button2 7 ^background : 
xcalc*hp . button2 8 ^background : 
xcalc*hp . button2 9 ^background : 
xcalc*hp .button30*background: 



#ffff00 
#f£ff00 
#ffffff 
#ffffff 
#ffffff 
#ffff00 
#ffff00 
#ffffff 
#ffffff 
tffffOO 
#ffff00 



#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
#00294d 
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1.3 Xdefaults File 



xcalc*hp.button31 background: #002 9 4d 
xcalc*hp.button32*background: #00294d 
xcalc*hp.button33*background: #002 94d 
xcalc*hp.button3 4 background: #002 94d 
xcalc*hp.button35*background: #00294d 
xcalc*hp.button36*background: #002 94d 
xcalc*hp.button37 background: #002 94d 
xcalc*hp.button38 background: #002 94d 
xcalc*hp.button3 9 background: #002 9 4d 
xcalc*hp.buttonl*foreground: #ffff 00 
xcalc*hp.button2*foreground: #ffff00 
xcalc*hp.button3*foreground: #ffff00 
xcalc*hp.button4*foreground: #ffff 00 
xcalc*hp.button5*foreground: #ff ff 00 
xcalc*hp.button6*foreground: #ffff 00 
xcalc*hp.button7*foreground: #ffffff 
xcalc*hp.button8*foreground: #fffff f 
xcalc*hp.button9*foreground: #ffffff 
xcalc*hp.buttonlO*foreground: #ffff00 
xcalc*hp.buttonll*foreground: #ffff00 
xcalc*hp.buttonl2*foreground: #ffff00 
xcalc*hp.buttonl3*foreground: #ffff00 
xcalc*hp.buttonl4*foreground: #ffff 00 
xcalc*hp.buttonl5*foreground: #ffff00 
xcalc*hp.buttonl6*foreground: #ffff00 
xcalc*hp.buttonl7*foreground: #ffff ff 
xcalc*hp.buttonl8*foreground: #ffff ff 
xcalc*hp.buttonl9*foreground: #ffffff 
xcalc*hp.button20*foreground: #ffff00 
xcalc*hp.button21*foreground: #ffff 00 
xcalc*hp.button22*foreground: #ffff00 
xcalc*hp.button23*foreground: #ffff00 
xcalc*hp.button24*foreground: #ffff00 
xcalc*hp.button25*foreground: #ffff00 
xcalc*hp.button2 6*foreground: #ffff 00 
xcalc*hp.button27*foreground: #ffffff 
xcalc*hp.button2 8*foreground: #ffffff 
xcalc*hp.button29*foreground: #ffffff 
xcalc*hp.button30*foreground: #ffff00 
xcalc*hp.button31*foreground: #ffff00 
xcalc*hp.button32*foreground: #ffff00 
xcalc*hp.button33*foreground: #ffff00 
xcalc*hp.button34*foreground: #ffff00 
xcalc*hp.button35*foreground: #ffff00 
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1.3 Xdefaults File 



xcalc*hp.button36*foreground: #ffffff 

xcalc*hp.button37*foreground: #ffff 00 

xcalc*hp.button38*foreground: #ffff 00 

xcalc*hp.button39*foreground: #ffff 00 
#endif 
# 

# 



xmh*Geometry : 
xmh*Font : 

xmh*InitialIncFile : 
xmh*MailWaitingFlag : 
xmh *print command : 
xmh*titlebar*reverseVideo : 
xmh*titlebar*Font : 
xmh*f olderButtons*close*label : 
xmh*f olderButtons*compose*label : 
xmh*f olderButtons*open*label : 
xmh* folderButtons*openInNew* label: 
xmh*f olderButtons*create*label : 
xmh*f olderButtons*delete*label : 
xmh*tocButtons*inc*label : 
xmh*tocButtons*next*label : 
xmh*tocButtons*prev*label : 
xmh*tocButtons*delete*label : 
xmh*tocButtons*move*label : 
xmh*tocButtons*copy*label : 
xmh*tocButtons*unmark*label : 
xmh*tocButtons*viewNew*label : 
xmh*tocButtons*reply*label : 
xmh*tocButtons*f orward*label : 
xmh*tocButtons*useAsComp*label : 
xmh*tocButtons*commit*label : 
xmh*tocButtons*openSeq*label : 
xmh*tocButtons*addToSeq*label : 
xmh*tocButtons*removeFromSeq*label: 
xmh*tocButtons*pick*label : 
xmh*tocButtons*deleteSeq*label : 
xmh*tocButtons*print*label : 
xmh*tocButtons*pack*label : 
xmh*tocButtons*sort*label : 
xmh*tocButtons*rescan*label : 
xmh*viewButtons*close*label : 
xmh*viewButtons*reply*label : 



650x750 
6x13 

true 

lpr 

on 

variable 

Close 

Compose 

Open 

Open in New 

Create 

Delete 

Inc 

View Next 

Prev 

Delete 

Move 

Copy 

Unmark 

View New 

Reply 

Forward 

Use as Comp 

Commit 

Open Seq 

Add to Seq 

Remove from Seq 

Pick 

Delete Seq 

Print 

Pack 

Sort 

Rescan 

Close 

Reply 
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1 .3 Xdefaults File 



xmh*viewButtons*f orward*label : 

xmh*viewButtons*useAsComp*label : 

xmh*viewButtons*edit*label : 

xmh*viewButtons*save*label : 

xmh*viewButtons*print*label : 

xmh*compButtons*close*label : 

xmh*compButtons*reset*label : 

xmh*compBut tons* compose* label : 

xmh*compButtons*save*label : 

xmh*compButtons*send*label : 

xmh*conf irm*yes*label : 

xmh*conf irm*no*label : 

xmh*prompt*goAhead*label : 

xmh*prompt*cancel*label : 

# 

####################### mwm 

# 

Mwm*shadowThickness : 

# 

# 

# Mwm*background: 
#ifdef COLOR 
Mwm*background : 
#endif 

# Mwm*background: 

# Mwm*topShadowColor : 

# Mwm*activeBackground: 
#ifdef COLOR 
Mwm*activeBackground : 
#endif 

# Mwm*activeBackground: 

# Mwm*activeTopShadowColor : 
!Mwm*iconImageBackground: 

# Mwm*iconImageBackground: 

# Mwm*iconImageTopShadowColor : 

# Mwm*matteBackground: 

# Mwm*matteTopShadowColor: 
# 

# Class Foreground 

# Mwm* foreground: varies 
#ifdef COLOR 

Mwm*foreground: #ffffff 

#endif 

# Mwm*bottomShadowColor: Black 



Forward 

Use as Comp 

Edit 

Save 

Print 

Close 

Reset 

Compose 

Save 

Send 

Yes 

No 

Go Ahead 
Cancel 



Motif Window Manager Defaults ############## 



Class Background — 
LightGray 

#6e645a 

White 
White 
CadetBlue 

#8blala 



#color 



#mo no chrome 



( 



tcolor 



White #Monochrome 

varies 

#8blala 

icon background 

icon top shadow color 

background 

top shadow color 



#Monochrome 



( 
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# Mwm*activebottomShadowColor : varies 

# Mwm*activeForeground: varies 
#ifdef COLOR 

Mwm*activeForeground: #ffff00 

#endif 

# Mwm* icon ImageBottomShadowCo lor: icon bottom shadow 

#ifdef COLOR 

Mwm*iconbox*Foreground: #002 9 4d 

#endif 

# Mwm* icon ImageForeground: icon foreground 

# Mwm*matteBottomShadowColor: bottom shadow color 

# Mwm*matteForground: foreground 
#ifdef COLOR 

Mwm*menu*foreground: #ffff00 

Mwm*menu*background: #8blala 

#endif 
# 

# Class BackgroundPixmap 

# Mwm*backgroundPixmap: NULL #Color 

# Mwm*backgroundPixmap: 75_foreground #Monochrome 

# Mwm*activebackgroundPixmap: NULL 

# 

# Class BottomShadowPixmap 

# Mwm*bottomShadowPixmap: NULL 

# Mwm*activeBottomShadowPixmap: NULL 

# Mwm*matteBottomShadowPixmap: bottom shadow pixmap 
# 

# Mwm*iconImageBottomShadowPixmap: icon bottom shadow pixmap 

# Class TopShadowPixmap 

# Mwm*topShadowPixmap: NULL #color 

# Mwm*topShadowPixmap: 50_forground #Monochrome 

# Mwm*activeTopShadowPixmap: NULL #color 

# Mwm*activeTopShadowPixmap: 50_f oreground #Monochrome 

# Mwm*iconImageTopShadowPixmap: icon top shadow pixmap 

# Class Fontlist 

# Mwm*fontlist: fixed 
Mwm*menu*fontList : variable 
Mwm*icon.fontList : variable 

Mwm*fontList : -bitstream-charter-bold-r-normal — 1 1-8 0-1 00-10 0-p- 69- 
iso8859-l 

# — Class SaveUnder 

# Mwm*saveUnder : F 

# ■ Class AutoKeyFocus 

# Mwm*autoKeyFocus : T 
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# ~ Class 

# Mwm*autoRaiseDelay: 

# Class 

# Mwm*bitMapDirectory : 

# Class 

# Mwm*buttonBindings : 

# 
Mwm*buttonBindings : 

# 

# Class 

# Mwm*cleanText : 

# Class 

# Mwm*clientAutoPlace: 

# Class 

# Mwm*clientDecoration: 
# 

Mwm*xclock*clientDecoration : 
Mwm*xload*clientDecoration : 
Mwm*xbif f *clientDecoration : 
Mwm*oclock*clientDecoration : 
Mwm*xcalc*clientDecoration : 
Mwm*xeyes*clientDecoration : 

# 

# Class 

# Mwm*clientFunctions : 
# 

# Class 

# Mwm*colormapFocusPolicy : 

# Class 

# Mwm*conf igFile : 

# Class 

# Mwm*deiconifyKeyFocus : 

# Class 

# Mwm*doubleClickTime: 

# Class 

# Mwm*enf orceKeyFocus : 

# Class 

# Mwm*f adeNormallcon: 
# 

Mwm* f adeNormallcon : 

# 

# Class 

# Mwm*f ocusAutoRaise : 

# ■ Class 
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AutoRaiseDelay 

500 # millisec 

BitmapDi rectory 

/usr/ include /Xll /bitmaps 

ButtonBindings 

NULL 

ExplicitButtonBindings 

CleanText 

T 

ClientAutoPlace 

T 

ClientDecoration 

all (all border maximize minimize) 

(none resizeh menu title) 
border resizeh 
title menu minimize 
title menu minimize 
title menu minimize maximize 
border title menu minimize 
title menu minimize 



Client Functions 

all (all none resize move) 

(minimize maximize close) 

Colo rmapFocusPol icy 

keyboard 

Conf igFile 

.mwmrc 

DeiconifyKeyFocus 

T 

DoubleClickTime 

500 # millisec 

Enf orceKeyFocus 

T 

FadeNormallcon 

F 



( 



FocusAutoRaise — 

T 

FrameBorderWidth 
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# Mwm*f rameBorderWidth: 5 # Pixels 

# Class IconAutoPlace 

# Mwm*iconAutoPlace: T 

# Class IconBoxGeometry ■ 

# Mwm* IconBoxGeometry: 6x1+0-0 
# 

Mwm* IconBoxGeometry: 3x1+611+5 

# 

# Class IconBoxName 

# Mwm*iconBoxName : iconbox 

# Class IconBoxTitle 

# Mwm*iconBoxTitle : Icons 
Mwm*iconBoxTitle: Demo Icons 

# Class IconClick 

# Mwm*iconClick: T 

# Class IconDecoration 

# Mwm*iconDecoration: varies 

# Class Iconlmage 

# Mwm* Iconlmage : (image) # pathname 
Mwm*xterm* Iconlmage : /usr/include/Xll/bitmaps/xlogo32 

# Class IconlmageMaximum 

# Mwm*iconImageMaximum: 50x50 

# Class IconlmageMinimum 

# Mwm* icon ImageMinimum: 32x32 

# Class IconPlacement 

# Mwm*iconPlacement : left bottom (top bottom left right) 

# Class IconPlacementMargin 

# Mwm*iconPlacementMargin : varies 

# Class InteractivePlacement 

# Mwm*interactivePlacement : F 

# Class KeyBindings 

# Mwm*keyBindings : system 

# Class KeyboardFocusPolicy 

# Mwm*keyboardFocusPolicy : explicit 
Mwm*keyboardFocusPolicy : pointer 

# Class LimitResize 

# Mwm*limitResize : T 

# Class LowerOnlconify 

# Mwm*lowerOnIconify : T 

# MatteWidth 

# Mwm*matteWidth: # pixels 

# Class MaximumClientSize 

# Mwm*maximumClientSize: fill the screen 

# Class MaximumMaximumSize 
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# Mwm*maximumMaximumSize : 2xscreen (w&h) 

# Class MoveThreshold 

# Mwm*moveThreshold: 4 # Pixels 

# Class PassButtons 

# Mwm*passbuttons: F 

# Class PassSelectButton 

# Mwm*passSelectButton: T 

# Class PositionlsFrame 

# Mwm*positionIsFrame: T 

# Class PositionOnScreen 

# Mwm*positionOnScreen: T 

# Class QuitTimeout 

# Mwm* quit Time out : 1000 # millisec 

# Class ResizeBorderWidth 

# Mwm*resizeBorderWidth: 10 # Pixels 

# Class ResizeCursors 

# Mwm*resizeCursors: T 

# Class ShowFeedback 

# Mwm* ShowFeedback: all (all behavior move none) 

# (placement resize restart) 
# ■ Class StartupKeyFocus 

# Mwm*startupKeyFocus : T 

# Class TransientDecoration 

# Mwm*transientDecoration: system title 

# Class TransientFunctions ■ 

# Mwm*transientFunctions : -minimi ze-maximize 

# Class UseClientlcon 

# Mwm*useClientIcon: F 
# 

# Mwm*def aults*useClientIcon: True 
# 

# Class UselconBox 

# Mwm*useIconBox: F 
Mwm*useIconBox: True 

# Class WindowMenu 

# Mwm*windowMenu: varies 

# Class WMenuButtonClick 

# Mwm*wMenuButtonClick: T 

# Class WMenuButtonClick2 

# Mwm*wMenuButtonClick2 : T 

# _ 



C 



( 



( 



A - 14 2.2 Release Notes 



Documentation Corrections 



B. Documentation Corrections 

You should note the following corrections to the ESV documentation with the 
2.2 Release. Change pages are found after this appendix. 

ESV Workstation User's Manual 

"4. Customizing the System" 

Several new features are documented in this chapter. Replace the existing 
chapter in your documentation with this new version. 

ESV Workstation Reference Manual 

"1. ES/PEX" 

This chapter has been updated to reflect the 2.2 Release functionality. Re- 
place the existing chapter in your documentation with this new version. 

"2. X Extensions" 

This chapter has been updated to reflect the 2.2 Release. Replace the existing 
chapter in your documentation with this new version. 

ESV Workstation Applications and Options 

"Helpful Hints" 

Helpful hints have been added. Add these new pages to your documentation. 

"Application Notes" 

A Table of Contents has been added. Application note 7 has been revised and 
application notes 8 and 9 have been added. Add these new pages to your doc- 
umentation. 

"Spaceball User's Manual [2.0]" 

On page 1-1, step 2 in the installation procedure should read: 

"2) Plug this end of the cable into the gender changer, and then into an un- 
used port (ttyO or tty3) of the ESV Workstation. 
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ES/PHIGS Reference Manual [2.0] 
SET DEPTH CUE REPRESENTATION 

The description for SET DEPTH CUE REPRESENTATION is incorrect. The 
description contradicts itself by first saying: "Refplanes and scaling entries of 
are back reference plane and corresponding scaling factors" and then say- 
ing: "The first number in scaling specifies the portion of the primitive colour 
that is combined with the depth cue colour at, or in front of, the front reference 
plane." 

The first statement is true, the second is false. 

SET ERROR HANDLER 

The SET ERROR HANDLER routine is incorrectly called SET ERROR 
HANDLING. 

Missing Functions 

The manual pages (both printed and on-line) are missing for the functions 
INQUIRE LIST OF AVAILABLE GENERALIZED STRUCTURE 
ELEMENTS and SET BACK REFLECTANCE EQUATION. 

INQUIRE LIST OF AVAILABLE GENERALIZED STRUCTURE 
ELEMENTS is similar in function to INQUIRE LIST OF AVAILABLE 
GENERALIZED DRAWING PRIMITIVES. The list of parameters for the two f 

routines is the same and can be found on the INQUIRE LIST OF AVAILABLE I 

GENERALIZED DRAWING PRIMITIVES manual page. 

SET BACK REFLECTANCE EQUATION is similar in function to SET 
REFLECTANCE EQUATION. The list of parameters for the two routines is 
the same and can be found on the SET REFLECTANCE EQUATION manual 
page. 
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Helpful Hints 

System 

Script Programming 



Make sure you never have if ( . . . ) in your script. Always have a space 
after each "if," as in if ($?TERM ==1). 

Password Protection for Single User Boot 

Turning on password protection for the single user boot requires a change to 
init and su. 

With the modified executables, if the file /etc/single.passreq exists then 
you must type in the root password before being allowed into single user 
mode. Therefore the only way to fix a corrupted passwd file when this mode 
is enabled is to boot the miniroot and mount the root filesystem to do repairs. 



xtitle 



The client xtitle has been added in the 2.2 Release. This utility can change the 
title of an xterm window, its icon, or both. The new string may be any valid 
string of characters. Special characters *, ?, /, [, ] must be escaped. If the string 
contains blanks, the entire expression must be placed in quotes ("). 



ES/PEX 

Specular and Light Concentration 



The ESV Workstation uses the specular concentration surface property and 
spot light concentration values differently from many other graphics devices. 
Other devices use these values as exponents in the lighting equation, raising 
a value to a power. As a result, large values (60 or more) are needed to create 
a tight highlight. The ESV Workstation treats these values like the other coef- 
ficients in the surface property. A value of gives highlights with minimum 
concentration, and a value of 1 gives maximum concentration. A useful equa- 
tion to convert values from another system to the value used by ESV Work- 
station is: ESV concentration = log(concentration) +,- log(256). 
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xdm 

If xdm error logging is activated and xdm runs for a long period of time, the 
disk space may fill up and the server crash. The rgb.dat file can be corrupted 
by such a crash. To prevent this, the xdmerror log file in the 2.2 Release has 
been set to the default value /dev/null. 

If you want the errors to go to a log file, you have to log in as root and 
edit the /usr/IIb/X11/xdm file by changing the line 

DisplayManager . errorLogFile : /dev/null 

to 

DisplayManager . errorLogFile : /usr/tmp/xdm-errors 

Multiscreen Selection Information 

The default .mwmrc file which is supplied with the ESV system in 
/usr/lib/X1 1/system.mwmrc allows screen selection to be done using one of 
the mouse keys. 

A possible alternative is to use keyboard keys to select screens. The fol- 
lowing could be added to your local .mwmrc file to accomplish this. Note that 
this was written for six screens but could be modified according to the number 
of screens the X server is started with. 

# .mwmrc ■ — mwm configuration file 
# 

# key binding descriptions 
# 

Keys DefaultKeyBindings 

{ 

Ctrl Shift<Key>Fl root i icon | window ! "screen 0" 

Ctrl Shift<Key>F2 root I icon | window '."screen 1" 

Ctrl Shift<Key>F3 root I icon | window ! "screen 2" 

Ctrl Shift<Key>F4 root I icon | window ! "screen 3" 

Ctrl Shift<Key>F5 root I icon | window ! "screen 4" 

Ctrl Shift<Key>F6 root I icon | window ! "screen 5" 

} 

Polyline Set Slowdown 

The DSPs need large polylines (about 15-30 coordinates minimum per 
polyline) in order to work efficiently and reach the maximum line drawing 
performance. 

Using PPERSPECTIVE with GDP Spheres Stops HLHSR 

If you use PPERSPECTIVE with GDP spheres, the hidden surface removal is 
effectively turned off even though HLHSR ID and mode are set. 
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List of Application Notes 

ANl. Exabyte 

AN2. Trackball 

AN3. Serial-to-Parallel Converter 

AN4. Video Extension Cables 

AN5. Distribution Amplifiers 

AN6. CIPHER Tape Drive 

AN7. External SCSI Cables and Terminators 

AN8. Peripheral Expansion Enclosures - Tabletop 

AN9. Peripheral Device Configuration 
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AN7. External SCSI Cables and Terminators 

Overview 

This application note describes the available external SCSI cables and termi- 
nators and the pertinent SCSI operating parameters. 

SCSI devices use two types of connectors: 

• 50-pin, "alternative-2," or "Alt2" 

(also called the "Amp Champ" or the "Centronics" type) 

• 50-pin, D 

Each external SCSI device requires an external SCSI cable which must be 
purchased separately. The specific cable needed will depend on the device be- 
ing purchased, the device(s) already present on the external SCSI bus, and fu- 
ture plans for adding additional devices. The last device on the external SCSI 
bus will require a terminator which must also be purchased separately. 

Operating Parameters 

A total of seven SCSI devices can be connected to the SCSI bus, in addition to 
the CPU. For example, four devices can be connected via external cables if 
the ESV has one tape drive and two disk drives installed inside the cabinet. 

There is an input and output connector provided on each external SCSI 
device. The input connector accommodates the cable from the host or 
previous device. The output connector is provided to allow for daisy chain 
configurations to the next device or the placement of a SCSI bus terminator. 
A terminator must be attached to the last device in the daisy chain. 

The total length of the external cable(s) cannot exceed 1 1 feet. This limi- 
tation includes SCSI cables that are often found inside external SCSI equip- 
ment such as disk-drive enclosures. Failure to properly install a terminator, 
the presence of more than one external terminator or the use of cable exceed- 
ing 1 1 feet may cause a system crash. 



Cables 



It is recommended that only the following cables be used with SCSI devices 
in order to avoid impedance discontinuity and EMI problems. There are five 
cables each of which are available in 2, 4, and 6 feet lengths: 
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Cable Number and Description 



P/N (2 ft) P/N (4 ft) P/N (6 ft) 



(1) male, 50-pin, Alt2 / male, 50-pin, D 

(2) male, 50-pin, Alt2 / male, 50-pin, Alt2 

(3) male, 50-pin, D / male, 50-pin, D 

(4) male, 50-pin, Alt2 /female, 50-pin, D 

(5) male, 50-pin, D / female, 50-pin, D 



423203-002 423203-004 
401013-002 401013-004 



423203-006 
401013-006 
401010-006 
401012-006 
401011-002 401011-004 401011-006 



401010-002 401010-004 
401012-002 401012-004 



In most cases cable 1 will be the correct cable to purchase for use with the 
first SCSI device to be connected to the ESV. Cable 2 will usually be the cor- 
rect cable to purchase when subsequent external SCSI devices are added to the 
system. The type of cable actually required can be determined by reading the 
appropriate application note for a particular SCSI device. Cable 1 will typical- 
ly be used in the 6 foot length and cable 2 will generally be used in the 2 foot 
length. However, any combination of cable lengths can be used as long as the 
total does not exceed 1 1 feet. 

Cables 3, 4, and 5 are used with the DS2000 Data Shuttle or other devices 
that have unusual connectors. Cable 3 can be used to connect the ESV to the 
DS2000 Data Shuttle. Cable 4 can be used to daisy chain devices with a Alt2 
connector to the DS2000 Data Shuttle. Cable 5 can be used to daisy chain 
DS2000 Data Shuttles to each other. 



Terminators 



Terminator 



male, 50-pin, Alt2 
male, 50-pin, D 
female, 50-pin, D 



Part Number 



Notes 



401258-050 most external SCSI devices use this 

terminator 

401272-050 used on the ESV, it must be attached to the I/O 

panel if no external SCSI devices are present 

401294-050 used with the DS2000 Data Shuttle 
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AN8. Peripheral Expansion Enclosures - Tabletop 



Functional Characteristics 

These enclosures allow 5-1/4 inch disk drives to be connected to the external 
SCSI bus. 

Product Details 

Three enclosures are available to meet the needs of users wanting to add one, 
two or three external 5 1/4-inch disk drives: 

P/N Max # Drives WxLxH (in) P/N (6 ft) 



405213-001 


1 


9.25X13.10X5.22 


12 lbs 


405213-002 


2 


14.00 X 16.50 X 5.22 


18 lbs 


405213-003 


3 


12.63X18.12X8.25 


30 lbs 



Maximum power requirements are approximately 0.75 A @ 120 VAC per 
disk drive. AC input voltage (auto ranging) is 90-260 VAC. AC input 
frequency is 47 to 63 Hz. Two Centronics-type (alternate 2) connectors are 
provided on each enclosure to facilitate connection to the external SCSI bus. 
These enclosures are suitable for tabletop placement. 



Supplemental Information 



An external SCSI cable must be purchased separately. To connect one of these 
enclosures directly to an ESV use part number 423203-XXX (where XXX in- 
dicates cable-length options). To daisychain an enclosure to another external 
SCSI device with a Centronics-type connector use part number 4010 13-XXX. 
These enclosures use approximately one foot of SCSI cable (inside the enclo- 
sure) for each disk drive. Therefore, the maximum external SCSI cable length 
should be reduced by an appropriate amount. If a terminator is required use 
part number 401258-050. (Remember that only one terminator is required on 
the external SCSI bus.) See Application Note 7 for additional instructions on 
selecting a cable or a terminator. 
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AN9. Peripheral Device Configuration 



Overview 



This note describes the various peripherals that are supported on the ESV 
Workstation and how they can be configured into the system. The first part of 
this note describes how to set up the device files to match the particular sys- 
tem configuration, and the second part gives a more detailed description of 
each device and any setup that may be necessary for its proper operation. 

The devices currently supported are listed below. 

Optical mouse 

CDRS dial box with labels 

Keyboard 

Wacom tablets 

SummaGraphics tablets 

Button box 

* Spaceball 

All these devices can be configured to work through the CPU's I/O port 
or the RDC. Exactly where the system expects the device to be is part of the 
configuration information in the device file. 



UNIX Device Files 



Device files are the special files (/dev/mouse, /dev/ttyO, etc.) that enable 
UNIX to "talk" to devices. These are not normal text files. To create them you 
have to use the UNIX mknod program. 

For example, if you log in as root and type the following: 

mknod /dev/mouse c 90 17 

you create the special device file called /dev/mouse and assign it the major 
number 90 and minor number 17. The major number tells UNIX which device 
driver to use. The minor number is then passed as a parameter to the specified 
device driver. 

The driver uses this information to setup the device and allow you to use 
it. The following are the devices and their major numbers. A particular device 
always uses the same major number, but may use different minor numbers for 
different configurations. 
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90 Optical mouse (1200 Baud) 

86 Optical mouse (9600 Baud) 

87 Keytronic 101 keyboard 

88 Wacom tablet (15 inch x 15 inch) 

9 1 Wacom tablet (18 inch x 25 inch) 
98 Wacom tablet (6 inch x 9 inch) 

85 SummaGraphics tablet (6 inch x 9 inch) 

93 SummaGraphics tablet (12 inch x 12 inch) 

89 CDRS dial box with labels 
83 Honeywell button box 

97 Spacial Systems Spaceball 



Keep in mind that each tablet is a different device to the device driver. If 
you have a Wacom 15 inch x 15 inch tablet you need to use major number 88. 
Another size or kind of tablet, however, has to use a different major number. 

The minor number has a special meaning to the driver. The minor number 
allows you to specify the RDC port and/or CPU port at which the device is 
located. (For more information on the RDC, see chapter 2, "Product 
Overview" in the ESV Workstation User's Manual.) In fact you could have 
two dial boxes, one called /dev/dials and the other called /dev/dials2 
plugged into the system at the same time. As long as the minor numbers 
specify different ports, they can both be used. The keyboard is the only 
exception to this. Only one keyboard is allowed. It is allowed only on port 2 
of the CPU or port A of the RDC (but not both). 

The minor number is an 8 bit integer that can have a value from to 255. 
The driver splits these 8 bits into two parts to determine the port information. 
The four least significant bits (bits 0-3) are used to identify the RDC port that 
the device can be plugged into. The four most significant bits (bits 4-6) iden- 
tify the CPU port that can be used. 

RDC ports 0-5 correspond to the labels A through F (with A reserved for 
keyboard only). An RDC port value of 15 instructs the device driver not to 
look on the RDC at all for the device. 

The CPU I/O ports are tricky because some have more than one function. 
They are described in table AN9-1 below. Refer to figure AN9-1 at the end 
of this note for the location of each port on the I/O panel and figure AN9-2 for 
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the location of the ports on the RDC. A CPU port value of 7 instructs the de- 
vice driver not to look on the CPU for the device. 



Table AN9-1. CPU I/O port functions 



Port Purpose 

Port This is a general purpose port. It has both RS232 and 6 pin 

DIN connector. Only one of these connectors can be in use 
at a time. It also has modem control lines hooked up. 

Port 1 This is the Mouse/RDC/Debug port. If there is no RDC on 

the system, then the mouse goes here. If there is an RDC, 
this is the port that the drivers use to talk to the RDC. Also 
the boot PROM uses this port for the debug terminal if it is 
enabled. 

Port 2 This is the keyboard port. If there is no RDC on the system, 

the keyboard is expected to be here. 

Port 3 This is a general purpose port like port including the 

modem control lines. 



When a device is opened the minor number is given to the driver's open 
routine. The driver then interprets this number according to the above de- 
scription. If a valid RDC port is given, the driver checks to see if there is an 
RDC attached. If there is an RDC, the driver sets up the connection to the de- 
vice through the RDC. If there is no RDC or the RDC port isn't valid and the 
CPU port is a valid port, then the driver attaches to the device which is con- 
nected to the valid CPU I/O panel port. 

For example, a device file with a minor number of 15 indicates that the 
device can only be on CPU port and it doesn't matter whether or not an RDC 
is installed. Similarly, a minor number of 1 16 (7*16 + 4 or hex 74) indicates 
that the device can only be on port 4 (RDC port E). If there is no RDC installed, 
the driver will refuse to open the device. 

When there is a choice of where the device might go, the driver tries first 
to find the RDC. If the RDC is not connected or not turned on, it is unable to 
respond and the driver connects to the I/O panel port. The RDC is only polled 
the first time a driver with a choice is opened. If there is no RDC detected, then 
it never tries the RDC again. It requires a system reset to be able to attach or 
disconnect an RDC and have the system recognize it. If the RDC is uninten- 
tionally left off when booting the system, this should be detected when the 
PROM fails to find the keyboard (assuming it is hooked up to the RDC). The 
boot process will not continue until things are right. 
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The default configuration of the mouse is a good example of a device 
which may be connected to either of two I/O ports. The mouse device file is 
set up by doing mknod /dev/mouse c 90 17. This tells the driver that device 
/dev/mouse uses device 90 with minor number 17. The 17 indicates that the 
mouse could be on port 1 of the CPU or port 1 (RDC port B) of the RDC. 

Unfortunately many of the devices give no indication that they are actu- 
ally attached except by sending data. So, once the driver decides where the 
device is (using the minor number), it just assumes that the device is actually 
there. If the device is not there or if a different device is there, then the driver 
may generate incorrect events or none at all. The keyboard, however, can be 
probed so the keyboard driver knows if the keyboard is actually attached to 
the port or not. 

The following is a list of the standard device files and their configurations . 
The minor numbers can be modified to fit specific situations. The information 
is specified in exactly the form the mknod program expects. 

/dev/mouse c 90 17 Optical mouse. Port 1 of the CPU, port B of 

the RDC (i.e., 1*16+1 or hex 11). 

/dev/kbd c 87 32 Keytronic 101 keyboard. Port 2 of the CPU, 

port A of the RDC (i.e., 2*16+0 or hex 20). 

/dev/tablet c 88 50 Wacom 15 x 15 inch tablet. Port 3 of the CPU, 

port C of the RDC (i.e., 3*16+2 or hex 32). 

/dev/dials c 89 3 CDRS dial box. Port of the CPU, port D of 

the RDC (i.e., 0*16+3 or hex 03). 

The following list is for the extra device files. These files must be hand 
configured because they may interfere with the standard devices. With an 
RDC it is possible to attach a total of eight devices (six on the RDC and two 
more on the CPU I/O panel). However, because of the variability of system 
configuration, it is necessary to set things up by hand. 

/dev/buttonbox c 83 4 Honey well button box. Port of the CPU, 

port E of the RDC (i.e., 0*16+4 or hex 04). 

/dev/spaceball c 97 5 Spacial Systems spaceball. Port Oof the CPU, 

port F of the RDC (i.e., 0*16+5 or hex 05). 



Optical Mouse 



The mouse has nothing to configure. The only option is a cable to allow it to 
plug into the RDC. 



( 
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Keyboard 



The keyboard is AT compatible. The default jumper setting from the factory 
is usually correct. If there is a problem, the dip switches are accessed by re- 
moving a small panel on the bottom of the keyboard. All four dip switches 
should be set in the off position. 

Two versions of this keyboard are supported, a North American version 
and a German version. Both use the same device major number (87). There is 
no way for the CPU to tell which type of keyboard is connected so it is neces- 
sary to set the PROM environment variable kbd to either (North American) 
or 1 (German). 

The German keyboard does not give access to all keys at the same time. 
Since everything must fit into the 128 character ASCII chart, the German key- 
board has two modes, a data processing mode and text processing mode. In 
text processing mode all the special German characters are displayed al- 
though they generate the same ASCII codes as other characters. In data pro- 
cessing mode, however, the normal ASCII symbols are displayed. To switch 
between modes press the ALTGR key and the SYSREQ keys simultaneously. 



Tablets 



All Wacom tablets are set at the factory for 9600 baud, 8 bits, 2 stop bits, and 
no parity. 

All SummaGraphics tablets are set at the factory for 9600 baud, 8 bits, 
2 stop bits, and odd parity. 

Control Dials 

The control dial box is configured at the factory to be 2400 baud, 8 bits, 2 stop 
bits, and no parity. 

Function Buttons 

The button box is configured at the factory to run at 9600 baud. No changes 
should need to be made. Currently the button box can only be plugged into an 
RDC. This is because the button box takes power from the connector and the 
CPU I/O panel does not provide that power. 



Spaceball 



Spaceball is set at the factory to run at 9600 baud. Spaceball has an external 
power supply that attaches to the cable on the spaceball. Spaceball can be 
plugged into either the CPU I/O panel or the RDC. For the I/O panel you need 
an RS232 male to male straight through cable. For the RDC you need an RS232 
male to 6-pin DIN (male) converter cable. 
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Figure AN9-2. RDC port configuration 
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